XConfigureWindow(display, w, value_mask, values)
Display *display;
Window w;
unsigned int value_mask;
XWindowChanges *values;
display | Specifies the connection to the X server. |
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. |
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).
XConfigureWindow() can generate BadMatch, BadValue, and BadWindow errors.
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. |