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

FreeBSD Manual Pages

  
 
  

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

NAME
     XtSetSelectionParameters  -  specify  target parameters for a selection re-
     quest with a single target

SYNTAX
     #include <X11/Intrinsic.h>

     void XtSetSelectionParameters(Widget requestor, Atom selection, Atom  type,
	    XtPointer value, unsigned long length, int format);

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

     selection Specifies the atom that names the selection.

     type      Specifies the type of the property in which the	parameters  will
	       be passed.

     value     Specifies a pointer to the parameters.

     length    Specifies  the  number of elements containing data in value, each
	       element of a sized indicated by format.

     format    Specifies the size in bits of the data in the elements of value.

DESCRIPTION
     The specified parameters will be copied and stored in a new property of the
     specified type and format on the requestor's window.  To initiate a  selec-
     tion  request  with  a  target  and  these parameters, a subsequent call to
     XtGetSelectionValue or  to  XtGetSelectionValueIncremental  specifying  the
     same  requestor  widget and selection atom will generate a ConvertSelection
     request referring referring to the property containing the parameters.   If
     XtSetSelectionParameters  is called more than once with the same widget and
     selection without a call to specify a request, the most recently  specified
     parameters are used in the subsequent request.

     The possible values of format may be 8, 16, or 32.  If the format is 8, the
     elements  of value are assumed to be sizeof(char); if 16, sizeof(short); if
     32, sizeof(long).

     To generate a MULTIPLE target request with parameters for any of the multi-
     ple targets of the selection request, precede individual calls to	XtGetSe-
     lectionValue and XtGetSelectionValueIncremental with corresponding individ-
     ual  calls to XtSetSelectionParameters, and enclose these all within XtCre-
     ateSelectionRequest and XtSendSelectionRequest.   XtGetSelectionValues  and
     XtGetSelectionValuesIncremental  cannot be used  to make selection requests
     with parameterized targets.

SEE ALSO
     XtGetSelectionParameters(3)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

X Version 11			   libXt 1.3.1	     XtSetSelectionParameters(3)

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

home | help