名称

XtGetSubresources, XtGetApplicationResources - サブリソースやアプリケーションリソースを取得する

形式

void XtGetSubresources(w, base, name, class, resources, num_resources, args, num_args)
      Widget w;
      caddr_t base;
      String name;
      String class;
      XtResourceList resources;
      Cardinal num_resources;
      ArgList args;
      Cardinal num_args; void XtGetApplicationResources(w, base, resources, num_resources, args, num_args)
      Widget w;
      caddr_t base;
      XtResourceList resources;
      Cardinal num_resources;
      ArgList args;
      Cardinal num_args;

引数

argsリソースデータベースから得たリソースをオーバーライドする 引数リストを指定します。

baseこのリソースが書込まれる 、サブパートデータ構造体のベースとアドレスを指定します。

classサブパートのクラスを指定します。

nameサブパートの名前を指定します。

num_args引数リスト中の引数の数を指定します。

num_resources
リソースリスト中のリソースの数を指定します。

resourcesサブパートのリソースリストを指定します。

wサブパートのリソースが欲しいウィジェット または検索するリソースデータベースを識別するためのウィジェットを指定します。

解説

XtGetSubresources 関数は、アプリケーション名/クラス、 すべての先祖の名前/クラス およびこのウィジェット自身から、ひとつの名前/クラスのリストを 組立てます。 それから、このリストに、渡された名前/クラスの対を追加します。 リソースが、引数リスト、リソースデータベース、 それからリソースリスト中に置かれたデフォルト値から取出されます。 それから、そのリソースはサブパートレコードへコピーされます。 args が NULL の場合、 num_args は 0 でなければなりません。 ただし、 num_args が 0 の場合は、 引数リストは参照されません。 XtGetApplicationResources 関数は、最初に、渡されたウィジェット （通常、アプリケーションシェル）を使用して、 リソースの名とクラスのリストを組立てます。 それから、 XtGetSubresources は、引数リスト、リソースデータベース、それとリソースリスト中に置かれた デフォルト値からリソースを検索します。 base 引数を各アドレスに加算した後で、 XtGetApplicationResources は、各リソースを、このリソースリスト中に与えられたアドレスへ コピーします。 args が NULL の場合、 num_args は 0 でなければなりません。 ただし、 num_args が 0 の場合、 その引数リストは参照されません。 アプリケーションリソースを指定するための移植性のある方法は、 それらを構造体のメンバとして宣言し、その構造体のアドレスを base 引数として渡すことです。

関連事項

XtGetResourceList(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 3.3