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.)
This event is selected for any window in a group of children by specifying the parent window with SubstructureRedirectMask.
typedef union _XEvent {
...
XConfigureRequestEvent xconfigurerequest;
...
} XEvent;
|
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;
|
| parent | The window that selected the event. This is the parent of the window being configured. | |
| window | The window that is being configured. | |
| x, y | The requested position for the upper-left pixel of the window's border relative to the origin of the parent window. | |
| width, height | The requested width and height in pixels for the window. | |
| border_width | The requested border width for the window. | |
| above | The sibling specified in the XConfigureWindow call, or Above if no sibling was specified. | |
| detail | None, 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_mask | A bit mask representing which elements of configuration are to be changed. |