Xlib − C Language X Interface

Xlib − C LibraryX11, Release 6.7 DRAFTindicate the primary selection. The target member is set to the atom that indicates the type theselection is desired in. The property member can be a property name or None. The time memberis set to the timestamp or CurrentTime value from the ConvertSelection request.The owner should convert the selection based on the specified target type and send a Selection-Notify event back to the requestor. Acomplete specification for using selections is given inthe XConsortium standard Inter-Client Communication Conventions Manual.10.13.5. SelectionNotify EventsThis event is generated by the X server in response to a ConvertSelection protocol request whenthere is no owner for the selection. When there is an owner, itshould be generated by the ownerof the selection by using XSendEvent. The owner of a selection should send this event to arequestor when a selection has been converted and stored as a property or when a selection conversioncould not be performed (which is indicated by setting the property member to None).If None is specified as the property in the ConvertSelection protocol request, the owner shouldchoose a property name, store the result as that property on the requestor window, and then send aSelectionNotify giving that actual property name.The structure for this event type contains:typedef struct {int type; /* SelectionNotify */unsigned long serial; /* # of last request processed by server */Bool send_event; /* true if this came from a SendEvent request */Display *display; /* Display the event was read from */Window requestor;Atom selection;Atom target;Atom property; /* atom or None */Time time;}XSelectionEvent;The requestor member is set to the window associated with the requestor of the selection. Theselection member is set to the atom that indicates the selection. For example, PRIMARY isusedfor the primary selection. The target member is set to the atom that indicates the converted type.For example, PIXMAP is used for a pixmap. The property member is set to the atom that indicateswhich property the result was stored on. If the conversion failed, the property member is setto None. The time member is set to the time the conversion took place and can be a timestamp orCurrentTime.230