XDestroyWindow(3X11)

名前
XDestroyWindow, XDestroySubwindows - ウィンドウの破棄

書式
XDestroyWindow(display, w)
      Display *display;
      Window w;

XDestroySubwindows(display, w)
      Display *display;
      Window w;

引き数

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

w   ウィンドウを指定。

説明
関数 は指定したウィンドウとその全てのサブウィンドウを破棄する。 これにより、X サーバは各ウィンドウに対して イベントを生成する。 このウィンドウは二度と参照してはならない。 引き数 w で指定したウィンドウがマップされている場合、このウィンドウは自 動的にアンマップされる。 イベントの順序は、与えられた任意のウィンドウを破棄できるようなものであ り、 は自分自身のウィンドウの前に下位ウィンドウに対して生成される。 それ以外の兄弟ウィンドウやサブヒエラルキーの間の順序には制約はない。 指定したウィンドウがルートウィンドウの場合には、(下位ウィンドウも含め て)破棄されるウィンドウはない。 ウィンドウがマップされている場合、破棄される前に隠していた他のウィンド ウで イベントが起きる。

はエラー を起こすことがある。

関数 は、指定したウィンドウの下位ウィンドウ全てをスタックの底から上に向かう 順で破棄する。 これにより、X サーバは各ウィンドウに対して イベントを生成する。 マップされているサブウィンドウが実際に破棄された場合、 は指定したウィンドウ上での イベントを X サーバに生成させる。 これは、多くのウィンドウを1つずつ消すよりもずっと効率的である。 処理の多くは各ウィンドウに対して行わなくても、ウィンドウ全てに対して1 度だけ行えばよいからである。 破棄されたサブウィンドウは、二度と参照してはならない。

は エラーを起こすことがある。

返り値

引き数 Window が、定義された Window を指していない。

関連項目
XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11)
Xlib - C Language X Interface