XmTrackingLocate(3X) UNIX System V XmTrackingLocate(3X)
NAME
XmTrackingLocate - a Toolkit function that provides a modal interaction.
SYNOPSIS
#include <Xm/Xm.h>
Widget XmTrackingLocate (widget, cursor, confine_to)
Widget widget;
Cursor cursor;
Boolean confine_to;
DESCRIPTION
XmTrackingLocate provides a modal interface for selection of a component.
It is intended to support context help. The function grabs the pointer
and returns the widget in which a button press occurs.
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.
confine_to
Specifies whether or not the cursor should be confined to widget
RETURN VALUE
Returns the widget in which a button press occurs. If the window in
which a button press occurs is not a widget, the function returns NULL.
10/89 Page 1