名称

XtNameToWidget, XtWindowToWidget − 文字列（ウィジェット名）からウィジェットへの翻訳、またはウィンドウからウィジェットへの翻訳

形式

Widget XtNameToWidget(reference, names);
      Widget reference;
      String names; Widget XtWindowToWidget(display, window)
      Display ∗display;
      Window window;

引数

displayウィンドウが定義されているディスプレイを指定します。

names希望するウィジェットの完全修飾名を指定します。

reference検索を開始するところのウィジェットを指定します。

windowウィジェットが欲しい（を含みたい）ウィンドウを指定します。

解説

XtNameToWidget 関数は、その名前が指定された names 中の最初の 構成要素であり、reference ウィジェットの ポップアップチルドレン (または、reference ウィジェットが compositeWidgetClass のサブクラスである場合は通常の子ウィジェット) であるウィジェットを検索します。 それから、そのウィジェットを新しい reference ウィジェットとして使用し、 最初の構成要素を指定された names から削除した後で検索を繰り返します。 指定されたウィジェットが見つからない場合は、 XtNameToWidget は NULL を返します。 なお、names 引数は、指定した reference ウィジェットに関係した ある 1つのウィジェットの名前を入れます。 そして、この reference ウィジェットの直接の子供でないウィジェットを 捜すときには、1つ以上のウィジェット名 ( それをピリオドでくぎって ) を入れることができます。 その名前に対して reference ウィジェットの 1つ以上の子があてはまる場合、 XtNameToWidget は、その子のどれを返すかわかりません。 Intrinsics ( 組込み関数 ) は、あるウィジェットに対しその全ての子が 一意な名前を持っていることを要求しないからです。 指定した names が 1つ以上の構成要素をもち、 その最初の構成要素に対して 1つ以上の子があてはまる場合、 もしその構成要素にあう枝を一つだけ調べてその名前のウィジェットがない時、 XtNameToWidget は NULL を返してもよいことになっています。 つまり、 XtNameToWidget は後戻りしてウィジェットツリーの他に当てはまる枝を探すことはしません。 XtWindowToWidget 関数は、指定されたウィンドウとディスプレイポインタから、 適切なウィジェットインスタンスを求めます。

関連事項

X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R