名称

XtDisplayInitialize — ディスプレイのツールキットのビューを初期化し、それをアプリケーションのコンテクストに追加する関数

形式

#include <Xm/Xm.h> Widget XtDisplayInitialize (app_context, display, application_name, application_class, options,

num_options, argc, argv )
XtAppContextapp_context ;
Display∗ display ;
Stringapplication_name ;
Stringapplication_class ;
XrmOptionDescRec options ;
Cardinalnum_options ;
Cardinal∗ argc ;
Stringargv ;

解説

XtDisplayInitialize は、アプリケーションを呼び出したコマンドラインをパース (解析) し、リソースデータベースをロードします。 XtDisplayInitialize は、通常 XtInitialize によって呼び出されるバックエンドルーチンです。 アプリケーションが 1 つ以上のディスプレイをオープンする必要がある場合は、XtDisplayInitialize が直接呼び出されます。 XtDisplayInitialize は、オープンされているディスプレイに渡されます。 XtOpenDisplay は、まだオープンディスプレイが生成されていない場合に使用することができます。

アプリケーションを呼び出したコマンドラインを XtDisplayInitialize に渡すことによって、関数は、ユーザがアプリケーションに対する (フォントや色のような) 特定のリソースを、実行時に指定可能にするために、コマンドラインをパース (解析) することができます。 XtDisplayInitialize は、コマンドラインを検索し、それらのオプションを削除します。 アプリケーションの残りの部分は、残りのオプションのみを参照します。

XtDislplayInitialize は、環境変数 LANG の値に基づいてデフォルトファイルのローカライズをサポートしています。 ユーザは、環境変数 LANG を使用することによって言語を指定することができます。 この値のエレメントは、固有のリソースファイルへのパスを設定するために使用されます。 以下の置換がパスの設定に使用されます。

•%N はアプリケーションの class_name に置き換えられます。

•%L は環境変数 LANG の値に置き換えられます。

•%l は環境変数 LANG の言語部分に置き換えられます。

•%t は環境変数 LANG の領域部分に置き換えられます。

•%c は環境変数 LANG のコードセットに置き換えられます。

•%% は % に置き換えられます。

環境変数 LANG が定義されていないか、あるいはその一部がなければ、それを参照する % エレメントは NULL に置き換えられます。

パスはコロンによって区切られたエレメントの列を含んでいます。 各エレメントは、ファイル名を示し、ファイル名はそれらの内の一つが成功するまで左から右へと検索されます。 検索を行う前に、置換が行われます。

注意: ファイル中の複数個の隣合ったスラッシュを 1 つのスラッシュに置き換える X/Open の規約を使用しています。

XtInitialize 関数は、以下のソースからリソース中にマージすることによってリソースデータベースをロードします。

•ローカルホスト上のアプリケーション特有の class リソース。

•ローカルホスト上のアプリケーション特有の user リソース。

•サーバ上のリソースプロパティあるいはローカルホスト上のユーザプリファレンスリソースファイル。

•ローカルホスト上のホストごとのユーザ環境リソースファイル。

•アプリケーションのコマンドライン行 (argv)。

アプリケーション特有のクラスリソースファイルをロードするために、XtDisplayInitialize は次のパス上で適切な置換を行います。

•/usr/lib/X11/%L/app-defaults/%N:/usr/lib/X11/app-defaults/%N

環境変数 LANG が定義されていなければ (あるいは、LANG を使用した最初のパスの検索が失敗した場合は)、検索は現在の言語を指定しない位置がデフォルトになります (/usr/lib/X11/app_defaults/%N)。

ユーザのアプリケーションのリソースファイルをロードするために、XtDisplayInitialize は以下のステップを実行します。

•ファイルを検索するために環境変数 XAPPLRESLANGPATH を使用します。 XAPPLRESLANGDIR に対して、以下の値が使用可能です。  ./%N:$HOME/app-defaults/%L/%N:$HOME/app-defaults/%N:$HOME/%L/%N:$HOME/%N

•これが失敗した場合、あるいは、XAPPLPRESLANGPATH が定義されておらず、XAPPLRESDIR が定義されていれば、パスとして以下のものを使用します。 XAPPLRESDIR%L/%N:XAPPLRESDIR%N

•それ以外の場合は、以下のパスを使用します。 $HOME/%L/%N:$HOME/%N

XAPPLRESLANGPATH の検索が成功せず、また、LANG が定義されていなければ、検索は XtInitialize の R3 の仕様 (実際には XtDisplayInitialize で記述されていること) によって使用される場合と等価であるということに注意してください。

XtDisplayInitialize に対するパラメータは、以下のように定義されます。

app_contextアプリケーションのコンテクストを指定します。

displayディスプレイを指定します。 ディスプレイは最大 1 つのアプリケーションコンテキスト中でしか存在できないということに注意してください。

application_name
アプリケーション名を指定します。

application_class
通常アプリケーションのすべてのインスタンスに対する一般名であるアプリケーションのクラス名を指定します。 規約によって、クラス名はアプリケーションの最初の文字の大文字と小文字を反転することによって形成されます。 クラス名は、リソースデータベースを初期化するために使用されるファイルを配置するために使用されます。

optionsアプリケーション特有のリソースに対して、コマンドラインをパース (解析) する方法を指定します。 オプションの引数は、XrmParseCommand にパラメータとして渡されます。

num_optionsオプションリストのエントリ数を指定します。

argcコマンドラインのパラメータ数へのポインタ指定します。

argvコマンドラインのパラメータを指定します。

関連事項

XtInitialize(3XM)

NEWS-OSRelease 4.1C