XmTrackingEvent(3X) — DG/UX R4.11MU05



XmTrackingEvent(3X)           SDK X11 R4.11MU05          XmTrackingEvent(3X)


NAME
       XmTrackingEvent--A Toolkit function that provides a modal interaction

SYNOPSIS
       #include <Xm/Xm.h>

       Widget XmTrackingEvent (widget, cursor, confineto, eventreturn)
            Widget    widget;
            Cursor    cursor;
            Boolean   confineto;
            XEvent    *eventreturn;


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



        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.

        confineto
               Specifies whether or not the cursor should be confined to
               widget.

        eventreturn
               Returns the ButtonRelease or KeyRelease event that causes the
               function to return.


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
       XmTrackingLocate(3X).


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