MirOS Manual: XtGetSelectionValue(3), XtGetSelectionValues(3)


XtGetSelectionValue(3Xt)  XT FUNCTIONS   XtGetSelectionValue(3Xt)

NAME

     XtGetSelectionValue, XtGetSelectionValues - obtain selection
     values

SYNTAX

     void XtGetSelectionValue(Widget w, Atom selection, Atom tar-
          get, XtSelectionCallbackProc 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 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.

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 XtGet-
     SelectionValue is called; in fact, it may be called before
     or after XtGetSelectionValue returns.

     The XtGetSelectionValues function is similar to XtGet-
     SelectionValue except that it takes a list of target types

XFree86                   Version 4.5.0                         1

XtGetSelectionValue(3Xt)  XT FUNCTIONS   XtGetSelectionValue(3Xt)

     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
     XtGetSelectionValue. The callback is called once with the
     corresponding client data for each target. XtGetSelection-
     Values 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(3Xt), XtOwnSelection(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.