XQueryTree(3X11)

名前
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
    子ウィンドウのリストが返される。

display
    X サーバへの接続を指定する。

nchildren_return
    子ウィンドウの数が返される。

parent_return
    親ウィンドウが返される。

root_return
    ルートウィンドウが返される。

w   子ウィンドウ、ルートウィンドウ、親ウィンドウ、子ウィンドウの数を求めたいウィンドウを指定する。

説明
関数 は指定したウィンドウに対して、ルートウィンドウのID, 親ウィンドウのID, 子ウィンドウのリストへのポインタ(子ウィンドウが無い場合には NULL)、こ のリスト中の子ウィンドウの数を返す。 子ウィンドウのリストは、最も奥のウィンドウから最も手前のウィンドウへの 順で、現在重なっている順番に作られる。 は問い合わせに失敗した場合に 0 を返し、成功の場合には 0 でない値を返 す。 不要になった NULL でない子ウィンドウのリストを解放するときには を使うこと。

バグ
本来はルートウィンドウの ID ではなく、screen * を返すべきである。

関連項目
XFree(3X11), XGetWindowAttributes(3X11), XQueryPointer(3X11)
Xlib - C Language X Interface