NAME

ConfigureRequest — X ConfigureRequest Event

WHEN GENERATED

A ConfigureRequest event reports when another client attempts to change a window’s size, position, border, and/or stacking order. 

This event differs from ConfigureNotify in that it delivers the parameters of the request before it is carried out.  This gives the client that selects this event (usually the window manager) the opportunity to revise the requested configuration before executing the XConfigureWindow() request itself or to deny the request.  (ConfigureNotify indicates the final outcome of the request.) 

SELECT WITH

This event is selected for any window in a group of children by specifying the parent window with SubstructureRedirectMask. 

XEVENT STRUCTURE NAME

typedef union _XEvent { ... XConfigureRequestEvent xconfigurerequest; ... } XEvent;

EVENT STRUCTURE

typedef struct { int type;  unsigned long serial; /∗ # of last request processed by server ∗/  Bool send_event; /∗ True if this came from SendEvent request ∗/  Display ∗display; /∗ Display the event was read from ∗/  Window parent;  Window window;  int x, y;  int width, height;  int border_width;  Window above;  int detail; /∗ Above, Below, BottomIf, TopIf, Opposite ∗/  unsigned long value_mask; } XConfigureRequestEvent;

EVENT STRUCTURE MEMBERS

parentThe window that selected the event.  This is the parent of the window being configured. 

windowThe window that is being configured. 

x, yThe requested position for the upper-left pixel of the window’s border relative to the origin of the parent window. 

width, heightThe requested width and height in pixels for the window. 

border_widthThe requested border width for the window. 

aboveThe sibling specified in the XConfigureWindow call, or Above if no sibling was specified. 

detailNone, Above, Below, TopIf, BottomIf, or Opposite.  Specifies the sibling window on top of which the specified window should be placed.  If this member has the constant None, then the specified window should be placed on the bottom. 

value_maskA bit mask representing which elements of configuration are to be changed. 

NOTES

The geometry is derived from the XConfigureWindow request that triggered the event. 
 

Xlib Reference Manual