XtOwnSelection(3Xt) XT FUNCTIONS XtOwnSelection(3Xt)
XtOwnSelection, XtOwnSelectionIncremental, XtDisownSelection
- set selection owner
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);
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.
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
XFree86 Version 4.5.0 1
XtOwnSelection(3Xt) XT FUNCTIONS XtOwnSelection(3Xt)
ownership either because someone else asserted later owner-
ship 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 XtOwnSelectionInrcremental 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.
XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(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.