XtOpenApplication(3Xt)

名前
XtOpenApplication, XtVaOpenApplication - ディスプレイの初期化・オープン・クローズを行う

書式
Widget XtOpenApplication(app_context_return, application_class, options, num_options, argc_in_out, argv_in_out, fallback_resources, widget_class, args, num_args)
      XtAppContext* app_context_return;
      String application_class;
      XrmOptionDescRec* options;
      Cardinal num_options;
      int* argc_in_out;
      String* argv_in_out;
      String* fallback_resources;
      WidgetClass widget_class;
      ArgList args;
      Cardinal num_args;

Widget XtVaOpenApplication(app_context_return, application_class, options, num_options, argc_in_out, argv_in_out, fallback_resources, widget_class, ...)
      XtAppContext* app_context_return;
      String application_class;
      XrmOptionDescRec* options;
      Cardinal num_options;
      int* argc_in_out;
      String* argv_in_out;
      String* fallback_resources;
      WidgetClass widget_class;

引き数

app_context_return
    アプリケーションコンテクストを指定する。

application_class
    このアプリケーションのクラス名を指定する。このクラス名は通常、このアプリケー ションの全てのインスタンスに対する一般的な名前である。

options
    アプリケーション固有のリソースに対するコマンド行の展開の仕方を指定する。 この引き数 options は、 へパラメータとして渡される。 詳しい情報については、Xlib を参照すること。

num_options
    options リスト内のエントリー数を指定する。

argc_in_out
    コマンド行のパラメータの数へのポインタを指定する。

argv_in_out
    コマンド行のパラメータを指定する。

fallback_resources
    アプリケーションのクラスリソースファイルのオープンや読み込みができない場合に使われるリソース値を指定する。または NULL を指定する。

widget_class
    生成されるシェルのウィジェットクラスを指定する。

args
    生成されるシェルウィジェットに対して、他のリソース指定を上書きする引き数 リストを指定する。

num_args
    引き数リスト内のエントリー数を指定する。

... 生成されるシェルウィジェットに対して、他のリソース指定を上書きする可変 長引き数を指定する。

説明
関数 の以下の動作を行い、生成されたシェルを返す。

•   まず を呼ぶ。

•   次に を呼ぶ。

•   さらに display_string に NULL, application_name に NULL を 指定して を呼ぶ。

•   最後に appcation_name に NULL を指定し、さらに指定された widget_class, args, num_args を使って を呼ぶ。

が返す、値が変更された argc と argv は argc_in_out と argv_in_out に返される。app_context_return が NULL でな い場合、生成されたアプリケーションコンテクストも返される。コマンド行 で指定されたディスプレイをオープンできない場合は、 はエラーメッセージを出し、アプリケーションを終了させる。 fallback_resources が NULL でない場合、 を呼ぶ前にこの値を使って が呼ばれる。

XtAppInitialize は に置き換えられており、 XtVaAppInitialize は に置き換えられている。

関連項目
XtAppInitialize(3Xt), XtVaAppInitialize(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface