Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xtgetselecf(3) [hpux man page]

XtGetSelectionValuesIncremental()										 XtGetSelectionValuesIncremental()

Name
  XtGetSelectionValuesIncremental - obtain multiple selection values using incremental transfers.

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

Inputs
  w	    Specifies the widget that is making the request.

  selection Specifies the particular selection desired (usually XA_PRIMARY or XA_SECONDARY).

  targets   Specifies the types of information about the selection that are being requested.

  count     Specifies the length of the targets and client_data arrays.

  callback  Specifies the callback procedure that is to be called to receive each selection value.

  client_data
	    Specifies an array of client data (one for each target type) each element of which will be passed to callback when it  is  called
	    for the corresponding element of targets.

  time	    Specifies the timestamp that indicates when the selection request was initiated.  This should be the timestamp of the event which
	    triggered this request; the value CurrentTime is not acceptable.

Availability
  Release 4 and later.

Description
  XtGetSelectionValuesIncremental() is similar to XtGetSelectionValueIncremental() except that it takes an array of target types and an array
  of  client  data and requests the current value of the selection be converted to each of the targets.  The effect is as if each target were
  specified in a separate call to XtGetSelectionValueIncremental(), except that XtGetSelectionValuesIncremental()  guarantees  that  all  the
  conversions will use the same selection value because the ownership of the selection cannot change in the middle of the list, as could hap-
  pen when calling XtGetSelectionValueIncremental() repeatedly.

  Note that the callback procedure passed to XtGetSelectionValuesIncremental() must be prepared to receive a segment of data for any  of  the
  requested  values.   It  is  not  guaranteed that all segments for one target will be delivered before any segments for the next target are
  delivered.

  See XtGetSelectionValueIncremental() for more information.

See Also
  XtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtGetSelectionValues(1),
  XtSelectionCallbackProc(2).

Xt - Selections 												 XtGetSelectionValuesIncremental()

Check Out this Related Man Page

XtGetSelectionValues()													    XtGetSelectionValues()

Name
  XtGetSelectionValues - obtain selection data in multiple formats.

Synopsis
  void XtGetSelectionValues(w, selection, targets, count, callback,
  client_data, time)
	 Widget w;
	 Atom selection;
	 Atom *targets;
	 int count;
	 XtSelectionCallbackProc callback;
	 XtPointer *client_data;
	 Time time;

Inputs
  w	    Specifies the widget that is making the request.  Must be of class core or any subclass thereof.

  selection Specifies the particular selection desired (usually XA_PRIMARY or XA_SECONDARY).

  targets   Specifies the types of information about the selection that are being requested.

  count     Specifies the length of the targets and client_data arrays.

  callback  Specifies the callback procedure to be called with each selection value obtained.  Note that this is how the selection values are
	    communicated back to the client.

  client_data
	    Specifies an array of client data (one for each target type) each element of which will be passed to callback when it  is  called
	    for the corresponding element of targets.

  time	    Specifies the timestamp that indicates when the selection value is desired.  This should be the timestamp of the event that trig-
	    gered this request; the value CurrentTime is not acceptable.

Description
  XtGetSelectionValues() is similar to XtGetSelectionValue() except that it takes an array of target types and an array of  client  data  and
  requests the current value of the selection converted to each of the targets.  The callback is called once for each element of targets, and
  is passed the corresponding element of client_data.  The effect is as if each target were specified in a separate call to XtGetSelectionVa-
  lue(),  except  that	XtGetSelectionValues() guarantees that all the conversions will use the same selection value because the ownership of
  the selection cannot change in the middle of the list, as could happen when calling XtGetSelectionValue() repeatedly.

  See XtGetSelectionValue() for more information.

See Also
  XtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1),
  XtSelectionCallbackProc(2).

Xt - Selections 													    XtGetSelectionValues()
Man Page