Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XtCreateSelectionRequest(3)	 XT FUNCTIONS	   XtCreateSelectionRequest(3)

NAME
       XtCreateSelectionRequest, XtSendSelectionRequest, XtCancelSelection-
       Request - bundle	multiple selection conversion requests into a single
       request using MULTIPLE target

SYNTAX
       void XtCreateSelectionRequest(Widget requestor, Atom selection):

       void XtSendSelectionRequest(Widget requestor, Atom selection, Time
	      time);

       void XtCancelSelectionRequest(Widget requestor, Atom selection);

ARGUMENTS
       requestor Specifies the widget making the request. Must be of class
		 Core or a subclass thereof.

       selection Specifies the particular selection desired.

       time	 Specifies the timestamp to be used in making the request.

DESCRIPTION
       When XtCreateSelectionRequest is	called,	subsequent calls to XtGetSe-
       lectionValue and	XtGetSelectionValueIncremental with the	requestor and
       selection as specified to XtCreateSelectionRequest will be bundled into
       a single	selection conversion request with multiple targets. The	re-
       quest is	actually initiated by calling XtSendSelectionRequest.

       When XtSendSelectionRequest is called with a value of requestor and se-
       lection matching	a previous call	to XtCreateSelectionRequest, a selec-
       tion conversion request is actually sent	to the selection owner.	 If a
       single target request is	queued,	that request is	made. If multiple tar-
       gets are	queued they are	bundled	into a single request with the target
       MULTIPLE	using the specified timestamp. As the conversions are made,
       the callbacks associated	with each XtGetSelectionValue and XtGetSelec-
       tionValueIncremental are	invoked	in turn.

       Multi-threaded applications should lock the application context before
       calling XtCreateSelectionRequest	and release the	lock after calling
       XtSendSelectionRequest to ensure	that the thread	assembling the request
       is safe from interference by another thread assembling a	different re-
       quest naming the	same widget and	selection.

       When XtCancelSelectionRequest is	called,	any requests queued since the
       last call to XtCreateSelectionRequest are cleaned up. Subsequent	calls
       to XtGetSelectionValue, XtGetSelectionValues, XtGetSelectionValueIncre-
       mental, and XtGetSelectionValuesIncremental will	not be deferred.

SEE ALSO
       X Toolkit Intrinsics - C	Language Interface
       Xlib - C	Language X Interface

X Version 11			  libXt	1.1.5	   XtCreateSelectionRequest(3)

NAME | SYNTAX | ARGUMENTS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XtCreateSelectionRequest&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help