NAME

       XmTrackingLocate  —  A  Toolkit  function  that  provides a modal interaction "XmTrackingLocate" "Toolkit
       functions" "XmTrackingLocate"

SYNOPSIS

       #include <Xm/Xm.h>
       Widget XmTrackingLocate(
       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.  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).

                                                                                             XmTrackingLocate(3)