XReconfigur(3x) — HP-UX 9.05

NAME

XReconfigureWMWindow − request that a top-level window be reconfigured.

Synopsis

Status XReconfigureWMWindow(display, w, screen_number, value_mask, values)

   Display *display;
   Window w;
   int screen_number;
   unsigned int value_mask;
   XWindowChanges *values;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay().

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

valuesSpecifies a pointer to the XWindowChanges structure.

Availability

Release 4 and later.

Description

XReconfigureWMWindow() 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 event is trapped and a synthetic ConfigureRequest event 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. For more information, see Volume One, Chapter 10, Interclient Communication.

Structures

typedef struct {
    int x, y;
    int width, height;
    int border_width;
    Window sibling;
    int stack_mode;
} XWindowChanges;

Errors

BadValue
BadWindow

Museum