XtOwnSelection(3Xt)                           XtOwnSelection(3Xt)



NAME
     XtOwnSelection,  XtDisownSelection  -  set  and  unset   the
     selection owner

SYNOPSIS
     Boolean XtOwnSelection(w, selection, time, convert-proc,
     lose-selection, done-proc)
     Widget w;
     Atom selection;
     Time time;
     XtConvertSelectionProc convert-proc;
     XtLoseSelectionProc lose-selection;
     XtSelectionDoneProc done-proc;

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

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 own-
     er 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 pro-
     cedure specified by lose_selection is not called if the
     widget fails to obtain selection ownership in the first
     place.

     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 be-
     cause 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 is called if a
     conversion that started before the call to XtDisownSelection
     finishes after the call to XtDisownSelection.

   Arguments
     These functions accept the following arguments:

     convert-proc
             Specifies the procedure that is to be called whenev-



November, 1990                                                  1

XtOwnSelection(3Xt)                           XtOwnSelection(3Xt)



             er someone requests the current value of the selec-
             tion.

     done-proc
             Specifies the procedure that is called after the re-
             quester 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 whenev-
             er 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 re-
             linquished.

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

SEE ALSO
     XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(3Xt)

     X Toolkit Intrinsics - C Language Interface

     Xlib - C Language Interface

























2                                                  November, 1990