OSF

NAME

XmTrackingLocate — a Toolkit function that provides a modal interaction.

SYNOPSIS

#include <Xm/Xm.h> Widget XmTrackingLocate (widget, cursor, confine_to)
Widgetwidget;
Cursorcursor;
Booleanconfine_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. 

widgetSpecifies 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. 

cursorSpecifies 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.