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

FreeBSD Manual Pages

  
 
  

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

NAME
     XtGetSelectionValue, XtGetSelectionValues - obtain selection values

SYNTAX
     #include <X11/Intrinsic.h>

     void  XtGetSelectionValue(Widget  w,  Atom selection, Atom target, XtSelec-
	    tionCallbackProc callback, XtPointer client_data, Time time);

     void XtGetSelectionValues(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 pro-
	       cedure 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  tar-
	       get.

     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 se-
	       lection.

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

     w	       Specifies the widget that is making the request.

DESCRIPTION
     The  XtGetSelectionValue  function requests the value of the selection that
     has been converted to the target type.   The  specified  callback	will  be
     called  some  time  after XtGetSelectionValue is called; in fact, it may be
     called before or after XtGetSelectionValue returns.

     The XtGetSelectionValues function is similar to XtGetSelectionValue  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 XtGet-
     SelectionValue.  The callback is called once with the corresponding  client
     data  for	each  target.	XtGetSelectionValues does guarantee 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 would be when calling
     XtGetSelectionValue repeatedly.

SEE ALSO
     XtAppGetSelectionTimeout(3), XtOwnSelection(3)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

X Version 11			   libXt 1.3.1		  XtGetSelectionValue(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XtGetSelectionValues&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help