Manual Pages for UNIX Operating System command usage for man XtOwnSelectionIncremental

XT FUNCTIONS                                  XtOwnSelection(3xt)



NAME
     XtOwnSelection, XtOwnSelectionIncremental, XtDisownSelection
     - set selection owner

SYNTAX
     cc [ flag... ] file... -lXt [ library... ]

     Boolean XtOwnSelection(Widget w, Atom selection, Time time,
          XtConvertSelectionProc convert_proc, XtLoseSelec-
          tionProc lose_selection, XtSelectionDoneProc
          done_proc);

     Boolean XtOwnSelectionIncremental(Widget w, Atom selection,
          Time time, XtConvertSelectionIncrProc convert_callback,
          XtLoseSelectionIncrProc lose_callback, XtSelection-
          DoneIncrProc done_callback, XtCancelConvertSelec-
          tionProc cancel_callback, XtPointer client_data);

     void XtDisownSelection(Widget w, Atom selection, Time time);

ARGUMENTS
     convert_proc
               Specifies the procedure that is to be called when-
               ever someone requests the current value of the
               selection.

     done_proc Specifies the procedure that is called after the
               requestor has received the selection or NULL if
               the owner is not interested in being called back.

     lose_selection
               Specifies the procedure that is to be called when-
               ever the widget has lost selection ownership or
               NULL if the owner is not interested in being
               called back.

     selection Specifies an atom that describes the type of the
               selection (for example, XA_PRIMARY, XA_SECONDARY,
               or XA_CLIPBOARD).

     time      Specifies the timestamp that indicates when the
               selection ownership should commence or is to be
               relinquished.

     w         Specifies the widget that wishes to become the
               owner or to relinquish ownership.

DESCRIPTION
     The XtOwnSelection function informs the Intrinsics selection
     mechanism that a widget believes it owns a selection.  It
     returns True if the widget has successfully become the owner
     and False otherwise.  The widget may fail to become the



X Version 11        Last change: libXt 1.0.8                    1






XT FUNCTIONS                                  XtOwnSelection(3xt)



     owner if some other widget has asserted ownership at a time
     later than this widget.  Note that widgets can lose selec-
     tion ownership either because someone else asserted later
     ownership of the selection or because the widget voluntarily
     gave up ownership of the selection.  Also note that the
     lose_selection procedure is not called if the widget fails
     to obtain selection ownership in the first place.

     The XtOwnSelectionIncremental procedure informs the Intrin-
     sics incremental selection mechanism that the specified wid-
     get wishes to own the selection. It returns True if the
     specified widget successfully becomes the selection owner or
     False otherwise. For more information about selection, tar-
     get, and time, see Section 2.6 of the Inter-Client Communi-
     cation Conventions Manual.

     A widget that becomes the selection owner using XtOwn-
     SelectionIncremental may use XtDisownSelection to relinquish
     selection ownership.

     The XtDisownSelection function informs the Intrinsics selec-
     tion mechanism that the specified widget is to lose owner-
     ship of the selection.  If the widget does not currently own
     the selection either because it lost the selection or
     because it never had the selection to begin with, XtDisown-
     Selection does nothing.

     After a widget has called XtDisownSelection, its convert
     procedure is not called even if a request arrives later with
     a timestamp during the period that this widget owned the
     selection.  However, its done procedure will be called if a
     conversion that started before the call to XtDisownSelection
     finishes after the call to XtDisownSelection.

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


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:












X Version 11        Last change: libXt 1.0.8                    2






XT FUNCTIONS                                  XtOwnSelection(3xt)



     __________________________________________________________________
    |       ATTRIBUTE TYPE        |          ATTRIBUTE VALUE          |
    |_____________________________|___________________________________|
    | Availability                | x11/library/toolkit/libxt         |
    |_____________________________|___________________________________|
    | Interface Stability         | Committed                         |
    |_____________________________|___________________________________|
    | MT-Level                    | See XtToolkitThreadInitialize(3XT)|
    |_____________________________|___________________________________|














































X Version 11        Last change: libXt 1.0.8                    3