RcnfigWMWin(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

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.

RETURNS

Zero on failure, non-zero on success.

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