XmTrackingLocate

Motif 2.1 Programmer's Reference

XmTrackingLocate

A Toolkit function that provides a modal interaction

Format

#include <Xm/Xm.h>
Widget XmTrackingLocate
Widget
widgetCursor cursorBoolean
confine_to

DESCRIPTION

XmTrackingLocate provides a modal interface for selection of a component. It is intended to support context help. This function is implemented as XmTrackingEvent.

NOTE: 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.

confine_to

Specifies whether or not the cursor should be confined to widget

RETURN

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

XmTrackingEvent (3).