XmTrackingLocate(3X)													      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 discards succeeding events until BSelect is released or a key is pressed and then released. The function then returns the  wid-
       get 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.  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.   Specifies  the  cursor to be used for the pointer during the interaction. This is a standard X cursor name.  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(3X)

															      XmTrackingLocate(3X)