XRaiseWindow(3X11)

名前
XRaiseWindow, XLowerWindow, XCirculateSubwindows, XCirculateSubwindowsUp, XCirculateSubwindowsDown, XRestackWindows - ウィンドウのスタック順の変更

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

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

XCirculateSubwindows(display, w, direction)
      Display *display;
      Window w;
      int direction;

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

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

XRestackWindows(display, windows, nwindows);
      Display *display;
      Window windows[];
      int nwindows;

引き数

direction
    ウィンドウを移動させる方向(上か下)を指定。 か を指定する。

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

nwindows
    再スタックされるウィンドウの数を指定。

w   ウィンドウを指定。

windows
    再スタックされるウィンドウの配列を指定。

説明
関数 は指定したウィンドウが兄弟ウィンドウに隠されないように、スタックの最上 位に持ち上げる。 ウィンドウを机の上で重なりあっている紙として考えると、ウィンドウを持ち 上げることは、その紙をスタックの一番上に移動させることに例えられるが、 机の上での x, y 座標は変わらない。 マップされているウィンドウを持ち上げた場合、それまで隠されていたそのウィ ンドウとマップされているサブウィンドウでは イベントが発生する。

ウィンドウの override-redirect 属性が であり、親ウィンドウの を選択しているウィンドウが他にある場合、X サーバは イベントを生成し、処理を行わない。

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

関数 は他の兄弟ウィンドウを隠さないように、指定したウィンドウをスタックの最 下位に下げる。 ウィンドウを机の上で重なりあっている紙として考えると、ウィンドウを下げ ることは、その紙をスタックの一番下に移動させることに例えられるが、 机の上での x, y 座標は変わらない。 マップされているウィンドウを下げた時、それまで陰になっていた全てのウィ ンドウで イベントが起こる。

ウィンドウの override-redirect 属性が であり、親ウィンドウの を選択しているウィンドウが他にある場合、X サーバは イベントを生成し、処理を行わない。 そうでない場合には、ウィンドウはスタックの最下位に下げられる。

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

関数 は指定したウィンドウの子ウィンドウを指定した向きに循環させる。 を指定した場合は、 は他の子ウィンドウに隠されている、最も下にある子ウィンドウ(もしあれば) を持ち上げる。 を指定した場合は、 は他の子ウィンドウを隠している、最も上にある子ウィンドウ(もしあれば)を 下げる。 その後、それまで他のウィンドウの陰になっていたウィンドウに対して露出の 処理が行われる。 親ウィンドウの を選択しているウィンドウが他にある場合、X サーバは イベントを生成し、それ以上の処理を行わない。 子ウィンドウが実際に再スタックされた場合、X サーバは を生成する。

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

関数 は指定したウィンドウの最下位のマップされている子ウィンドウで、一部ある いは全体が他の子ウィンドウに隠されているものを持ち上げる。 全く隠されていない子ウィンドウは影響を受けない。 これは、 を指定した と等価な簡易関数である。

は を起こすことがある。

は指定したウィンドウの最上位のマップされている子ウィンドウで、他の子ウィ ンドウ一部あるいは全体を隠しているものを下位に移動させる。 完全に隠れているウィンドウは影響を受けない。 これは を指定した と等価な簡易関数である。

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

関数 は上位から下位の指定した順でウィンドウを再スタックする。 ウィンドウの配列の最初のウィンドウのスタック順は通常通りであるが、 配列中の他のウィンドウは最初のウィンドウの下にスタックされる。 他のウィンドウのスタック順は通常通りである。 配列中に指定したウィンドウの子ウィンドウでないものがある場合、それぞれ に対して エラーが起こる。

ウィンドウの override-redirect 属性が であり、親ウィンドウの を選択しているウィンドウが他にある場合、X サーバは override-redirect フラグがセットされていないウィンドウ全てに対して イベントを生成し、それ以上の処理を行わない。 そうでない場合には、ウィンドウは上位から下位の順で再スタックされる。

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

返り値

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

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

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