XLIB Programming Manual, Rel. 5, Third Edition

Name

ConfigureRequest — xconfigurerequest

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

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