XLIB Programming Manual, Rel. 5, Third Edition

Name

SelectionRequest — xselectionrequest

When Generated

A SelectionRequest event is sent to the owner of a selection when another client requests the selection by calling XConvertSelection().

Select With

There is no event mask for SelectionRequest events, and they are not selected with XSelectInput.

XEvent Structure Name

typedef union _XEvent {
    ...
    XSelectionRequestEvent xselectionrequest;
    ...
} 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 owner;
    Window requestor;
    Atom selection;
    Atom target;
    Atom property;
    Time time;
} XSelectionRequestEvent;

Event Structure Members

The members of this structure have the values specified in the XConvertSelection call that triggers this event.

The owner should convert the selection based on the specified target type, if possible. If a property is specified, the owner should store the result as that property on the requestor window and then send a SelectionNotify event to the requestor by calling XSendEvent. If the selection cannot be converted as requested, the owner should send a SelectionNotify event with property set to the constant None.