Name

XtGetSelectionValue — obtain the complete selection data. 

Synopsis

void XtGetSelectionValue(w, selection, target, callback, client_data, time)

    Widget w;
    Atom selection;
    Atom target;
    XtSelectionCallbackProc callback;
    XtPointer client_data;
    Time time;

Arguments

wSpecifies the widget that is making the request. 

selectionSpecifies the particular selection desired (either XA_PRIMARY or XA_SECONDARY). 

targetSpecifies the type to which the sender should convert the selection. 

callbackSpecifies the callback procedure to be called when the selection value has been obtained.  Note that this is how the selection value is communicated back to the client. 

client_data
Specifies an argument to be passed to callback when it is called. 

timeSpecifies the timestamp that indicates when the selection is desired.  This should be the timestamp of the event that triggered this request; the value CurrentTime is not acceptable. 

Description

XtGetSelectionValue requests the selection owner to send the value of the selection, converted to the target type.  callback will be called some time after XtGetSelectionValue is called; in fact, it may be called before or after XtGetSelectionValue returns. 

If multiple calls to the server are required to get all the data, this will be transparent to the widget; the Intrinsics perform all the necessary fragmentation and reassembly of the selection. 

To determine the actual target types that the selection owner will be willing to return, intern the string TARGETS using XInternAtom, and send the corresponding Atom as target. 

See Also

XtGetSelectionValues(1), XtGetSelectionValueIncremental(1), XtOwnSelection(1),
XtSelectionCallbackProc(2).