XmTrackingLocate(Xm) 6 January 1993 XmTrackingLocate(Xm) Name XmTrackingLocate - a Toolkit function that provides a modal interaction Syntax #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 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 interac- tion 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. See also XmTrackingEvent(Xm)