XtLoseSeleA(3x) — HP-UX ANSI C A.10.11

NAME

XtLoseSelectionIncrProc − interface definition for a procedure called when the selection owner loses ownership.

Synopsis

typedef void (*XtLoseSelectionIncrProc)(Widget, Atom*, XtPointer);

    Widget w;
    Atom *selection;
    XtPointer client_data;

Inputs

wSpecifies the widget that has lost the selection ownership.

selectionSpecifies the atom that names the selection.

client_data
Specifies the value passed in by the widget when it took ownership of the selection.

Availability

Release 4 and later.

Description

An XtLoseSelectionIncrProc is optionally registered in a call to XtOwnSelectionIncremental(), and is called by the Intrinsics to inform the selection owner that the selection has been claimed by another widget or another client. This procedure is not called if the selection owner relinquishes selection ownership by calling XtDisownSelection(). It should do whatever is appropriate for the widget or application upon losing the ownership of the selection. Note that this procedure is not a request to the widget to relinquish selection ownership; it is called after the widget has already lost the selection.

Usage

Most selection owners will want to display selected data specially highlighted, and so will need to be informed when they lose the selection so that they can unhighlight that data. An XtLoseSelectionIncrProc is used in the Intrinsics incremental selection transfer mechanism. An XtLoseSelectionProc is a similar procedure used by the more convenient atomic transfer mechanism. An XtLoseSelectionProc does not have a client_data argument.

Museum