XtOwnSelection(3Xt) XtOwnSelection(3Xt)
NAME
XtOwnSelection, XtOwnSelectionIncremental,
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;
Boolean XtOwnSelectionIncremental(w, selection, time,
convert_callback, lose_callback, done_callback,
cancel_callback, client_data)
Widget w;
Atom selection;
Time time;
XtConvertSelectionIncrProc convert_callback;
XtLoseSelectionIncrProc lose_callback;
XtSelectionDoneIncrProc done_callback;
XtCancelConvertSelectionProc cancel_callback;
caddr_t client_data;
void XtDisownSelection(w, selection, time)
Widget w;
Atom selection;
Time time;
ARGUMENTS
cancel_callback
Specifies the callback procedure.
client_data
Specifies the argument that is to be passed
to the appropriate procedure when one of the
condition occurs.
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
- 1 -
XtOwnSelection(3Xt) XtOwnSelection(3Xt)
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 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 XtOwnSelectionIncremental informs the Intrinsics
incremental selection mechanism that the specified
widget believes it owns the selection. It returns True
if the specified widget successfully becomes the
selection owner or False otherwise.
Widgets that use the incremental transfer mechanism
should use XtDisownSelection to relinquish selection
ownership.
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
- 2 -
XtOwnSelection(3Xt) XtOwnSelection(3Xt)
call to XtDisownSelection.
SEE ALSO
XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(3Xt)
X Toolkit Intrinsics Programming Manual
Xlib Programming Manual
- 3 -