NAME    [Toc]    [Back]

       XmTrackingLocate  -  A  Toolkit  function  that provides a
       modal interaction

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

       Widget XmTrackingLocate (widget, cursor, confine_to)
               Widget widget;
               Cursor cursor;
               Boolean confine_to;

DESCRIPTION    [Toc]    [Back]

       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.  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    [Toc]    [Back]

       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    [Toc]    [Back]

       XmTrackingEvent(3X)



                                             XmTrackingLocate(3X)