XmTrackingLocate(3X) — DG/UX 5.4R3.00



XmTrackingLocate(3X)          X11 SDE 5.4R3.00          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 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.



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

RELATED INFORMATION
       XmTrackingEvent(3X).














Licensed material--property of copyright holder(s)                         1
Museum
