XmTrackingLocate(3X) OSF/Motif XmTrackingLocate(3X)NAMEXmTrackingLocate - A Toolkit function that provides a modal interaction
SYNOPSIS
#include <Xm/Xm.h>
Widget XmTrackingLocate (widget, cursor, confine_to) Wid‐
get widget; Cursor cursor; Boolean confine_to;
DESCRIPTIONXmTrackingLocate provides a modal interface for selection of a compo‐
nent. It is intended to support context help. The function grabs the
pointer and discards succeeding events until BSelect is released or a
key is pressed and then released. The function then returns the widget
or gadget that contains the pointer when BSelect is released or a key
is released.
This function is obsolete and exists for compatibility with previous
releases. It has been replaced by XmTrackingEvent.
Specifies the widget ID of a widget to use as the basis of the modal
interaction. That is, the widget within which the interaction must
occur, usually a top level shell. Specifies the cursor to be used for
the pointer during the interaction. This is a standard X cursor name.
Specifies whether or not the cursor should be confined to widget
RETURN VALUE
Returns the widget or gadget that contains the pointer when BSelect is
released or a key is released. If no widget or gadget contains the
pointer, the function returns NULL.
RELATED INFORMATIONXmTrackingEvent(3X).
XmTrackingLocate(3X)