名称

XUnmapWindow, XUnmapSubwindows - ウィンドウをアンマップする

形式

XUnmapWindow(display, w)
      Display ∗display;
      Window w; XUnmapSubwindows(display, w)
      Display ∗display;
      Window w;

引数

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

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

解説

XUnmapWindow 関数は、指定されたウィンドウをアンマップし、X サーバに、 UnmapNotify イベントを発生させます。 指定されたウィンドウがすでにアンマップされている場合は、 XUnmapWindow は、何も行いません。 隠されていたウィンドウについては、正規のエクスポーズ処理が行われます。 子ウィンドウは、他のマップコールが親ウィンドウにされない限り、もはや 見ることはできません。 つまり、サブウィンドウはマップされても、親ウィンドウがマップされるま では、表示されません。 ウィンドウをアンマップすることにより、 前に隠れていたウィンドウについての Expose イベントを発生します。 XUnmapWindow は、 BadWindow エラーを生じることがあります。 XUnmapSubwindows 関数は、指定されたウィンドウのすべてのサブウィンドウを、スタッフされ た順にアンマップします。 そして X サーバは、各々のサブウィンドウに UnmapNotify イベントを、そして前に隠れていたウィンドウに Expose イベントを発行します。 この関数を使えば、一度に複数のウィンドウをアンマップするより、ずっと 効果的です。 なぜならば、サーバはほとんどの作業を全てのウィンドウに対し、一度は行 わなければならないからです。 XUnmapSubwindows は、 BadWindow エラーを生じることがあります。

診断

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

関連事項

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

NEWS-OSRelease 4.2.1R