XmTrackingLocate(3X)

     NAME
          XmTrackingLocate - A Toolkit function that provides a modal
          interaction

     SYNOPSIS
          #include <Xm/Xm.h>
          Widget XmTrackingLocate(
          Widget widget,
          Cursor cursor,
          Boolean confine_to);

     VERSION
          This page documents Motif 2.1.

     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
          BSelectis released or a key is released. If no widget or
          gadget contains the pointer, the function returns NULL.

     RELATED
          XmTrackingEvent(3).