書式

XUnmapWindow(display, w)

      Display *display;

      Window w;

XUnmapSubwindows(display, w)

      Display *display;

      Window w;

引き数

display

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

w

ウィンドウを指定する。

説明

関数 XUnmapWindow は、指定したウィンドウをアンマップし、X サーバに UnmapNotify イベントを生成させる。 指定したウィンドウが既にアンマップされている場合、 XUnmapWindow は何もしない。 アンマップ以前にこのウィンドウに隠されていたウィンドウの露出(exposure) の処理は普通に行われる。 親ウィンドウに対するマップが改めて行われない限り、全ての子ウィンドウは 不可視になる。 つまり、サブウィンドウは依然マップされたままであるが、親がマップされる までは不可視になる。 ウィンドウのアンマップは、アンマップする前にこのウィンドウに隠されてい たウィンドウに Expose イベントを生成させる。

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

関数 XUnmapSubwindows は、指定したウィンドウの全てのサブウィンドウを、スタックの底から先頭の 順にアンマップする。 X サーバは各サブウィンドウ上で UnmapNotify イベントを生成し、それまでそのウィンドウに隠されていたウィンドウ上で Expose イベントを生成する。 この関数は複数のウィンドウを1つずつアンマップするよりもずっと効率的で ある。なぜなら X サーバは、全てのウィンドウを相手に処理を一度だけ行え ばよく、各々のウィンドウひとつひとつに対応しなくてよいからである。

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

返り値

BadWindow

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