XtOwnSelection(3X11)    COMMAND REFERENCE    XtOwnSelection(3X11)



NAME
     XtOwnSelection, XtDisownSelection - set 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;

     This is user-contributed.

ARGUMENTS
     convert_proc
               Specifies the procedure that is to be called
               whenever 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
               whenever 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            1 September 1988                        1

XtOwnSelection(3X11)    COMMAND REFERENCE    XtOwnSelection(3X11)



     owner if some other widget has asserted ownership at a time
     later than this widget.  Note that widgets can lose
     selection 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 XtDisownSelection function informs the Intrinsics
     selection mechanism that the specified widget is to lose
     ownership 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, XtDisownSelection 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(3x11), XtGetSelectionValue(3x11)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface




























X Version 11            1 September 1988                        2

%%index%%
na:552,107;
sy:659,2067;
de:2726,2377;
se:5103,441;
%%index%%000000000085