XReconfigureWMWindow

Syntax

Status XReconfigureWMWindow(display, w, screen_number, value_mask, values)
      Display *display;
      Window w;
      int screen_number;
      unsigned int value_mask;
      XWindowChanges *values;

Arguments

display Specifies the connection to the X server.
w Specifies the window.
screen_number Specifies the appropriate screen number on the host server.
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 XReconfigureWMWindow() function issues a ConfigureWindow request on the specified top-level window. If the stacking mode is changed and the request fails with a BadMatch error, the error is trapped by Xlib and a synthetic ConfigureRequestEvent containing the same configuration parameters is sent to the root of the specified window. Window managers may elect to receive this event and treat it as a request to reconfigure the indicated window. It returns a nonzero status if the request or event is successfully sent; otherwise, it returns a zero status.

XReconfigureWMWindow() can generate BadValue and BadWindow errors.

Diagnostics

BadWindow A value for a Window argument does not name a defined Window.

See also

XChangeWindowAttributes(), XConfigureWindow(), XCreateWindow(), XDestroyWindow(), XIconifyWindow(), XMapWindow(), XRaiseWindow(), XUnmapWindow(), XWithdrawWindow(), "Manipulating Top-Level Windows".
Christophe Tronche, ch@tronche.com