XLIB Programming Manual, Rel. 5, Third Edition

Name

MapRequest — xmaprequest

When Generated

A MapRequest event occurs when the functions XMapRaised() and XMapWindow() are called.

This event differs from MapNotify 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 size or position of the window before executing the map request itself or to deny the request. (MapNotify indicates the final outcome of the request.)

Select With

This event is selected by specifying the window ID of the parent of the receiving window with SubstructureRedirectMask. (In addition, the override_redirect member of the XSetWindowAttributes structure for the specified window must be False.)

XEvent Structure Name

typedef union _XEvent {
    ...
    XMapRequestEvent xmaprequest;
    ...
} 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;
} XMapRequestEvent;

Event Structure Members

parent

The ID of the parent of the window being mapped.

window

The ID of the window being mapped.