XtSetValues(3Xt) — UNIX Programmer’s Manual

名称

XtSetValues, XtSetSubvalues, XtGetValues, XtGetSubvalues − ウィジェットのリソースの取得および設定をする

シンタックス

void XtSetValues(w, args, num_args)
      Widget w;
      ArgList args;
      Cardinal num_args; void XtSetSubvalues(base, resources, num_resources, args, num_args)
      caddr_t base;
      XtResourceList resources;
      Cardinal num_resources;
      ArgList args;
      Cardinal num_args; void XtGetValues(w, args, num_args)
      Widget w;
      ArgList args;
      Cardinal num_args; void XtGetSubvalues(base, resources, num_resources, args, num_args)
      caddr_t base;
      XtResourceList resources;
      Cardinal num_resources;
      ArgList args;
      Cardinal num_args;

引数

argsリソース名およびリソース値をストアするアドレスかあるいはそれらの新しい値のどちらかを含む名前/アドレスのペアの引数リストを指定します。

baseリソースを検索したり書き込んだりすべきサブパートのデータ構造体のベースアドレスを指定します。

num_args引数リストにおける引数の数を指定します。

resourcesウィジェットでないリソースのリストあるいは値を指定します。

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

wウィジェットを指定します。

解説

XtSetValues 関数は、 Core ウィジェットフィールドに対して指定されたリソースで開始され、サブクラス連鎖をたどってウィジェットまで進みます。これは、各段階において、新しい値（引数のいずれかで指定された場合）あるいは既存の値（新しい値が指定されない場合）を新しいウィジェットデータレコードに書き込みます。 XtSetValues は次にスーパークラスからサブクラスへの順番でウィジェットに対する set_values プロシージャを呼び出します。ウィジェットが、ナルでない set_values_hook フィールドをもっている場合は、それらは対応する set_values プロシージャの直後に呼び出されます。このプロシージャで、サブクラスは、 XtSetValues に対してウィジェットでないデータを設定することができます。ウィジェットの親が constraintWidgetClass のサブクラスである場合は、 XtSetValues はウィジェットの制約も更新します。これは、 constraintWidgetClass に対して指定された制約リソースから開始し、サブクラス連鎖をたどって親クラスまで進みます。各段階において、これは新しい値あるいは既存の値を新しい制約レコードに書き込みます。これは次に constraintWidgetClass から順番に親クラスまで制約 set_values プロシージャを呼び出します。制約 set_values プロシージャは、widget 引数で呼び出されます。あらゆる set_values プロシージャに関する限りでは、それは制約レコード引数ではないので、それらはウィジェットに関する完全な情報に基づいて希望する値に調整することができます。 XtSetValues は、現在のウィジェットと新しいウィジェットを比較することによって、ジオメトリリクエストが必要か否かを決定します。ジオメトリリクエストが必要な場合は、これはリクエストを出し、ジオメトリマネージャは XtGeometryYes、 XtGeometryAlmost、 あるいは XtGeometryNo を返します。 XtGeometryYes の場合は、 XtSetValues はウィジェットのサイズ変更プロシージャを呼び出します。 XtGeometryNo の場合は、 XtSetValues は、ジオメトリフィールドを元の値にリセットします。 XtGeometryAlmost の場合は、 XtSetValues は、set_values_almost プロシージャを呼び出し、何をなすべきかを決定し、ジオメトリフィールドに対する新しい値をウィジェットに書き込みます。 XtSetValues はこのプロセスを繰り返して、ジオメトリマネージャを呼び出すべきか否かをもう１度判断します。最後に、set_values プロシージャのいずれかで真が返された場合は、 XtSetValues は、ウィジェットのウィンドウ上に Xlib XClearArea 関数を呼び出すことによって、ウィジェットのエクスポーズプロシージャが呼び出します。 XtSetSubvalues 関数は、リソースを基数によって識別される構造体内にストアします。 XtGetValues 関数は、コアウィジェットフィールドに対して指定されたリソースから開始し、サブクラス連鎖をたどってウィジェットまで進みます。渡された引数リストの値フィールドには、対応するリソース値をストアするアドレスが含まれていなければなりません。この記憶領域を、ウィジェット内で使用されるリソース表現のタイプのサイズに応じて割当てしたり割当てを解除したりするのは、呼び出し側の仕事です。ウィジェットの親が constraintWidgetClass のサブクラスである場合は、 XtGetValues は、要求されたリソースに対する値を取り出します。これは、 constraintWidgetClass に対して指定された制約リソースから開始し、サブクラス連鎖をたどって親の制約リソースまで進みます。引数リストに、検索されたリソースリストのどれにもなかったリソース名が含まれる場合は、対応するアドレスにある値は修正されません。最後に、get_values_hook プロシージャがナルでない場合は、それらは、すべてのリソース値が XtGetValues によって取り出された後で、スーパークラスからサブクラスへの順序で呼び出されます。これによって、サブクラスは widget でないリソースデータを XtGetValues に提供することができます。 XtGetSubvalues 関数は、基数によって識別された構造体からリソースを得ます。

Museum

XtSetValues(3Xt) — UNIX Programmer’s Manual

名称

シンタックス

引数

解説

関連事項