名称

XQueryTree − ウィンドウの木情報を問合わせる

形式

Status XQueryTree(display, w, root_return, parent_return, children_return, nchildren_return)
      Display ∗display;
      Window w;
      Window ∗root_return;
      Window ∗parent_return;
      Window ∗∗children_return;
      unsigned int ∗nchildren_return;

引数

children_return
子ウィンドウのリストを指すポインタを返します。

displayX サーバへのコネクションを指定します。

nchildren_return
子ウィンドウの数を返します。

parent_return
親ウィンドウを返します。

root_returnルートウィンドウを返します。

w得たい子ウィンドウのリスト、ルート・ウィンドウ、親ウィンドウおよび子ウィンドウの数をもつウィンドウを指定します。

解説

XQueryTree 関数は、指定されたウィンドウについてのリストにあるルート ID 、 親ウィンドウ ID 、 子ウィンドウのリストを指すポインタ、および子の数を返します。 子は、一番下 ( 最初 ) から一番上 ( 最後 ) の現在のスタック順序で リストされています。 XQueryTree は、失敗した場合は零を、成功した場合は非零の値を返します。 このリストが不要となったときは、 XFree を使用して、それを解放します。

バグ

これにより、ルートウィンドウ ID でなく、スクリーン ∗ が返されなければ なりません。

関連事項

XGetWindowAttributes(3X11), XQueryPointer(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3