MirOS Manual: XtSetSelectionParameters(3)


XtSetSelectionParameters(3XXT FUNCTIXtSetSelectionParameters(3Xt)

NAME

     XtSetSelectionParameters - specify target parameters for a
     selection request with a single target

SYNTAX

     void XtSetSelectionParameters(Widget requestor, Atom selec-
          tion, 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 ele-
               ments 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 selection request with a target and
     these parameters, a subsequent call to XtGetSelectionValue
     or to XtGetSelectionValueIncremental specifying the same
     requestor widget and selection atomm will generate a Con-
     vertSelection 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 multiple targets of the selection request, pre-
     cede individual calls to XtGetSelectionValue and XtGetSelec-
     tionValueIncremental with corresponding individual calls to
     XtSetSelectionParameters, and enclose these all within
     XtCreateSelectionRequest and XtSendSelectionRequest. XtGet-
     SelectionValues and XtGetSelectionValuesIncremental cannot
     be used  to make selection requests with parameterized

XFree86                   Version 4.5.0                         1

XtSetSelectionParameters(3XXT FUNCTIXtSetSelectionParameters(3Xt)

     targets.

SEE ALSO

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

XFree86                   Version 4.5.0                         2

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.