XUnmapWindow(3X11)

名前
XUnmapWindow, XUnmapSubwindows - ウィンドウのアンマップ

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

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

引き数

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

w   ウィンドウを指定。

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

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

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

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

返り値

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

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