XtGetSelectionValuesIncremental man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



XtGetSelectionValueIncremenXTlXtGetSelectionValueIncremental(3Xt)

NAME
       XtGetSelectionValueIncremental, XtGetSelectionValues-
       Incremental - obtain selection values

SYNTAX
       void XtGetSelectionValueIncremental(w, selection, target,
       callback, client_data, time)
	     Widget w;
	     Atom selection;
	     Atom target;
	     XtSelectionCallbackProc callback;
	     XtPointer client_data;
	     Time time;

       void XtGetSelectionValuesIncremental(w, selection, tar-
       gets, count, callback, client_data, time)
	     Widget w;
	     Atom selection;
	     Atom *targets;
	     int count;
	     XtSelectionCallbackProc callback;
	     XtPointer client_data;
	     Time time;

ARGUMENTS
       callback Specifies the callback procedure that is to be
		 called when the selection value has been
		 obtained.

       client_data
		 Specifies the argument that is to be passed to
		 the specified procedure when it is called.

       client_data
		 Specifies the client data (one for each target
		 type) that is passed to the callback procedure
		 when it is called for that target.

       count	Specifies the length of the targets and
		 client_data lists.

       selection Specifies the particular selection desired (that
		 is, primary or secondary).

       target	Specifies the type of the information that is
		 needed about the selection.

       targets	Specifies the types of information that is
		 needed about the selection.

       time	Specifies the timestamp that indicates when the
		 selection value is desired.

       w	 Specifies the widget that is making the request.

X Version 11		Release 6.4				1

XtGetSelectionValueIncremenXTlXtGetSelectionValueIncremental(3Xt)

DESCRIPTION
       The XtGetSelectionValueIncremental function is similar to
       XtGetSelectionValue except that the selection_callback
       procedure will be called repeatedly upon delivery of mul-
       tiple segments of the selection value.  The end of the
       selection value is indicated when selection_callback is
       called with a non-NULL value of length zero, which must
       still be freed by the client. If the transfer of the
       selection is aborted in the middle of a transfer (for
       example, because to timeout), the selection_callback pro-
       cedure is called with a type value equal to the symbolic
       constant XT_CONVERT_FAIL so that the requestor can dispose
       of the partial selection value it has collected up until
       that point. Upon receiving XT_CONVERT_FAIL, the requesting
       client must determine for itself whether or not a par-
       tially completed transfer is meaningful.

       The XtGetSelectionValuesIncremental function is similar to
       XtGetSelectionValueIncremental except that it takes a list
       of target types and a list of client data and obtains the
       current value of the selection converted to each of the
       targets. The effect is as if each target were specified
       in a separate call to XtGetSelectionValueIncremental.  The
       callback is called once with the corresponding client data
       for each target. XtGetSelectionValuesIncremental does
       guarantee that all the conversions will use the same
       selection value becaues the ownership of the selection
       cannot change in the middle of the list, as would be when
       calling XtGetSelectionValueIncremental repeatedly.

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

X Version 11		Release 6.4				2

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net