名称

XReparentWindow − ウィンドウの親を変える

形式

XReparentWindow(display, w, parent, x, y)
      Display ∗display;
      Window w;
      Window parent;
      int x, y;

引数

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

parent親ウィンドウを指定します。

wウィンドウを指定します。

x

y新しい親ウィンドウ中の位置の、x と y 座標を指定します 。

解説

指定されたウィンドウがマップされている場合、 XReparentWindow は、自動的に、そのウィンドウ上に UnmapWindow リクエストを行い、階層中の現在の位置から、それを削除し、 指定された親ウィンドウの子ウィンドウとして、それを挿入します。 そのウィンドウは、同位のウィンドウに関して、最上位のスタック順序に 置かれます。 指定されたウィンドウの親を変更した後で、 XReparentWindow は、X サーバに、 ReparentNotify イベントを発生させます。 このイベントに返される override_redirect メンバは、ウィンドウの 対応属性に設定されます。 一般に、ウィンドウマネジャのクライアントは、このメンバが True に設定されている場合は、このウィンドウを無視するべきです。 最後に、指定されたウィンドウが、初めからマップされている場合は、 X サーバは、自動的に、そのウィンドウ上に、 MapWindow リクエストを行います。 X サーバは、以前に隠されていたウィンドウについて、通常のエクスポージャ 処理を行います。 X サーバは、最後の MapWindow リクエストにより、すぐに邪魔されてしまった初期の UnmapWindow リクエストからのリージョンについて Expose イベントは発生してはいけません。 次のような場合、結果として、 BadMatch エラーが生じます。

•新しい親ウィンドウが、古い親ウィンドウと同一のスクリーン上に 存在しないとき。

•新しい親ウィンドウが指定されているウィンドウであるか、 指定されているウィンドウの下位に存在するとき。

•新しい親ウィンドウは InputOnly であるが、元のウィンドウが違うとき。

•指定されたウィンドウが、 ParentRelative バックグラウンドをもち、新しい親ウィンドウが、指定されているウィンドウ と同じ深さでないとき。 XReparentWindow は、 BadMatch および BadWindow エラーを生じることがあります。

診断

BadWindow
Window 引数の値が、定義された Window を指さない。

関連事項

XChangeSaveSet(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R