XmTrackingLocate(3X) SDK X11 R4.11MU05 XmTrackingLocate(3X)
NAME
XmTrackingLocate--A Toolkit function that provides a modal
interaction
SYNOPSIS
#include <Xm/Xm.h>
Widget XmTrackingLocate (widget, cursor, confineto)
Widget widget;
Cursor cursor;
Boolean confineto;
DESCRIPTION
XmTrackingLocate provides a modal interface for selection of a
component. 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.
widget 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.
cursor Specifies the cursor to be used for the pointer during the
interaction. This is a standard X cursor name.
confineto
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 INFORMATION
XmTrackingEvent(3X).
Licensed material--property of copyright holder(s)