名称

XDestroyWindow, XDestroySubwindows − ウィンドウを破壊する

形式

XDestroyWindow(display, w)
      Display ∗display;
      Window w; XDestroySubwindows(display, w)
      Display ∗display;
      Window w;

引数

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

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

解説

XDestroyWindow 関数は、指定されたウィンドウとすべてのサブウィンドウを破壊し、 各ウィンドウについて X サーバが DestroyNotify イベントを発生するようにさせます。 ウィンドウは、再び参照してはなりません。 w 引数で指定したウィンドウがマップされている場合、 それは自動的にアンマップされます。 DestroyNotify イベントは、次のような順序で発行されます。 つまり、破壊するウィンドウについて、 DestroyNotify は、ウィンドウそれ自体に発行される前に、 それより下位のウィンドウに発行されます。 同位のウィンドウ間や副階層のウィンドウ間の順序は、 その他の面では制約を受けません。 ルートウィンドウを指定した場合、どのウィンドウも破壊されません。 マップされたウィンドウを破壊すると、このウィンドウによって 隠されていた他のウィンドウで Expose イベントが発生します。 .PN XDestroyWindow は、 BadWindow を生じることがあります。 XDestroySubwindows 関数は、指定されたウィンドウの下位レベルのすべてのウィンドウを スタック順の下から上へ破壊します。 これによって、X サーバは、各ウィンドウについて DestroyNotify イベントを発行します。 マップされたサブウィンドウが実際に破壊された場合、 XDestroySubwindows によって X サーバは指定されたウィンドウに Expose イベントを発行します。 これは、多くのウィンドウを一度にひとつずつ削除するのよりも かなり効率的です。 なぜなら作業の多くは、各ウィンドウについてではなく、すべてのウィンドウ について一度しか行う必要がないからです。 サブウィンドウは、再び参照してはなりません。 .PN XDestroySubwindows は、 BadWindow エラーを生じることがあります。

診断

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

関連事項

XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3