Xlib Reference Manual: XConfigureWindow

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.
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.

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.

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.

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.com