XLIB Programming Manual, Rel. 5, Third Edition

Name

MappingNotify — xmapping

When Generated

A MappingNotify event is sent when any of the following is changed by another client: the mapping between physical keyboard keys (keycodes) and keysyms, the mapping between modifier keys and logical modifiers, or the mapping between physical and logical pointer buttons. These events are triggered by a call to XSetModifierMapping() or XSetPointerMapping(), if the return status is MappingSuccess, or by any call to XChangeKeyboardMapping().

This event type should not be confused with the event that occurs when a window is mapped; that is a MapNotify event. Nor should it be confused with the KeymapNotify event, which reports the state of the keyboard as a mask instead of as a keycode.

Select With

The X server sends MappingNotify events to all clients. It is never selected and cannot be masked with the window attributes.

XEvent Structure Name

typedef union _XEvent {
    ...
    XMappingEvent xmapping;
    ...
} 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 window;           /* unused */
    int request;             /* one of MappingMapping, MappingKeyboard,
                              * MappingPointer */
    int first_keycode;       /* first keycode */
    int count;               /* range of change with first_keycode*/
} XMappingEvent;

Event Structure Members

request

The kind of mapping change that occurred: MappingModifier for a successful XSetModifierMapping ...