XConfigureWindow
Syntax
XConfigureWindow(display, w, value_mask, values)
Display *display;
Window w;
unsigned int value_mask;
XWindowChanges *values;
Arguments
| display
| Specifies the connection to the X server.
Xサーバへの接続を指定。
|
| w
| Specifies the window to be reconfigured.
再設定するウィンドウを指定。
|
| value_mask
| Specifies which values are to be set using information in
the values structure.
This mask is the bitwise inclusive OR of the valid configure window values bits.
構造体の値を使ってセットする対象の値を指定。
このマスクは有効なウィンドウ設定値ビットの論理和である。
|
| values
| Specifies the
XWindowChanges
structure.
XWindowChanges
構造体を指定。
|
Description
The
XConfigureWindow()
function uses the values specified in the
XWindowChanges
structure to reconfigure a window's size, position, border, and stacking order.
Values not specified are taken from the existing geometry of the window.
XConfigureWindow()
は
XWindowChanges
構造体で指定された値を用いて、
ウィンドウの大きさ、
位置、
境界、
スタック順を再設定する。
指定されていない値は、
そのウィンドウの現在のジオメトリから求める。
If a sibling is specified without a stack_mode or if the window
is not actually a sibling,
a
BadMatch
error results.
Note that the computations for
BottomIf,
TopIf,
and
Opposite
are performed with respect to the window's final geometry (as controlled by the
other arguments passed to
XConfigureWindow()),
not its initial geometry.
Any backing store contents of the window, its
inferiors, and other newly visible windows are either discarded or
changed to reflect the current screen contents
(depending on the implementation).
stack_mode 無しで siblng が指定されて、
あるいはウィンドウが兄弟ウィンドウでない場合には、
エラー
BadMatch
となる。
BottomIf,
TopIf,
Opposite
の計算は、
ウィンドウの最初のジオメトリではなく、
(XConfigureWindow()
に渡された他の引き数で制御された)
最終的なジオメトリに対して実行される。
ウィンドウ、
下位ウィンドウ、
新しく可視状態になったウィンドウの
バッキングストアの内容は破棄されるか、
スクリーンの最新の内容を反映するように変更される。
(これは実装に依存する)
XConfigureWindow()
can generate
BadMatch,
BadValue,
and
BadWindow
errors.
XConfigureWindow()
はエラー
BadMatch,
BadValue,
BadWindow
を起こすことがある。
Diagnostics
| BadMatch
| An
InputOnly
window is used as a Drawable.
|
| BadMatch
| Some argument or pair of arguments has the correct type and range but fails
to match in some other way required by the request.
|
| BadValue
| Some numeric value falls outside the range of values accepted by the request.
Unless a specific range is specified for an argument, the full range defined
by the argument's type is accepted. Any argument defined as a set of
alternatives can generate this error.
|
| BadWindow
| A value for a Window argument does not name a defined Window.
|
See also
XChangeWindowAttributes(),
XCreateWindow(),
XDestroyWindow(),
XMapWindow(),
XMoveWindow(),
XMoveResizeWindow(),
XRaiseWindow(),
XResizeWindow(),
XSetWindowBorderWidth(),
XUnmapWindow(),
"Configuring Windows"
Christophe Tronche, ch.tronche@computer.org