名称

XtDisplayInitialize, XtOpenDisplay, XtDatabase, XtCloseDisplay - ディスプレイを初期化、オープンまたはクローズする

形式

void XtToolkitInitialize() void XtDisplayInitialize(app_context, display, application_name, application_class,
                       options, num_options, argc, argv)
      XtAppContext app_context;
      Display ∗display;
      String application_name;
      String application_class;
      XrmOptionDescRec ∗options;
      Cardinal num_options;
      Cardinal ∗argc;
      String ∗argv; Display ∗XtOpenDisplay(app_context, display_string, application_name, application_class,
                       options, num_options, argc, argv)
       XtAppContext app_context;
       String display_string;
       String application_name;
       String application_class;
       XrmOptionDescRec ∗options;
       Cardinal num_options;
       Cardinal ∗argc;
       String ∗argv; void XtCloseDisplay(display)
      Display ∗display; XrmDatabase XtDatabase(display)
      Display ∗display;

引数

argcコマンド行パラメタの個数を指すポインタを指定します。

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

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

application_class
このアプリケーションのクラス名を指定します。 これは通常このアプリケーションのすべてのインスタンスを総称する名前です。

application_name
アプリケーションインスタンスの名前を指定します。

displayリソースを得るためのディスプレイを指定します。 なお、ディスプレイはただ 1 つのアプリケーションコンテキストの中にしか おけないことに注意すること。

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

optionsいろいろなアプリケーション固有のリソースに対するコマンド行の解釈方法を 指定します。 この options 引数は、 XrmParseCommand へのパラメタとして渡されます。 詳細な情報については、 Xlib − C Language X Interface を参照してください。

解説

XtDisplayInitialize 関数は、リソースデータベースを構築して、コマンド行を解釈するために、 Xlib の XrmParseCommand 関数を呼び出し、 その他のディスプレイ関連の初期設定を行います。 XrmParseCommand が呼び出された後には、 argc と argv は、標準オプションテーブル中にも options 引数が 指定するテーブル中にもないパラメタだけがはいっています。 変更された argc が 1 でない場合は、 ほとんどのアプリケーションは単に、ゆるされているオプションをリスト しているメッセージとともに、その変更された argv を表示すれば よいでしょう。 UNIX ベースのシステムでは、 アプリケーション名はふつうは、 argv[0] の一番うしろの要素です。 synchronize リソースが指定されたアプリケーションに対して synchronize リソースが True の場合、 XtDisplayInitialize は、 Xlib の XSynchronize 関数を呼び出し、このディスプレイのコネクションに対して Xlib を 同期モードにします。 reverseVideo ( 反転表示 ) リソースが True の場合、Intrinsics ( 組込み関数 ) は、 このディスプレイの上で作成されたウィジェットに対して XtDefaultForeground と XtDefaultBackground をいれかえます（9.6.1 節参照）。 XtOpenDisplay 関数は、 XOpenDisplay を指定されたディスプレイ名を使って呼び出します。 display_string が NULL の場合、 XtOpenDisplay は、 argv で指定された −display オプションの現在の値を使用します。 argv にディスプレイが指定されていない場合は、ユーザのデフォルト ディスプレイを使用します ( UNIX ベースのシステムでは、 これは DISPLAY 環境変数の値 ) 。 これが成功した場合、次に XtDisplayInitialize を呼び出し、それに、オープンしたディスプレイと、 argv に指定されている −name オプションの値をアプリケーション名として 渡します。 name オプションが指定されていない場合 XtDisplayInitialize は、 XtOpenDisplay に渡されたアプリケーション名を使用します。 アプリケーション名が NULL の場合は、 XtDisplayInitialize は argv[0] の最後の要素を使用します。 XtOpenDisplay は、新しくオープンしたディスプレイを返すか、それが失敗した場合は NULL を返します。 XtOpenDisplay は、アプリケーションプログラマの便宜上提供されています。 XtCloseDisplay 関数は、クローズしてもよい状態になるとすぐに、指定されたディスプレイを クローズします。 XtCloseDisplay は、イベントディスパッチ内から呼び出された場合（たとえば、 コールバックプロシージャ）、 ディスパッチが完了するまで、ディスプレイをクローズしません。 なお、ディスプレイをクローズした後も実行を続けるような アプリケーションのみが、 XtCloseDisplay を呼び出す必要があります。 したがって、そうでない場合は、アプリケーションは、 XtDestroyApplicationContext を呼び出すか、単に exit するのがよいでしょう。 XtDatabase 関数は、パラメータとしてこのディスプレイを与えられた XtDisplayInitialize によって構築された、完全にマージされたリソースデータベースを返します。 このディスプレイが、 XtDisplayInitialize により初期化されていない場合は、 結果は定義されません。

関連事項

XtAppCreateShell(3Xt), XtCreateApplicationContext(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 3.3