1XmTrackingEvent(library call)                    XmTrackingEvent(library call)
2
3
4

NAME

6       XmTrackingEvent — A Toolkit function that provides a modal interaction
7

SYNOPSIS

9       #include <Xm/Xm.h>
10       Widget XmTrackingEvent(
11       Widget widget,
12       Cursor cursor,
13       Boolean confine_to,
14       XEvent *event_return);
15

DESCRIPTION

17       XmTrackingEvent  provides  a  modal interface for selection of a compo‐
18       nent.  It is intended to support context help.  The function calls  the
19       XmUpdateDisplay  function.   XmTrackingEvent then grabs the pointer and
20       discards succeeding events until  BSelect  is  released  or  a  key  is
21       pressed  and  then  released.   The function then returns the widget or
22       gadget that contains the pointer when BSelect is released or a  key  is
23       released, and ungrabs the pointer.
24
25       widget    Specifies  the  widget  ID of a widget to use as the basis of
26                 the modal interaction. That is, the widget within  which  the
27                 interaction must occur, usually a top-level shell.
28
29       cursor    Specifies  the  cursor  to be used for the pointer during the
30                 interaction.  This is a standard X cursor name.
31
32       confine_to
33                 Specifies whether or not the cursor  should  be  confined  to
34                 widget.
35
36       event_return
37                 Returns the ButtonRelease or KeyRelease event that causes the
38                 function to return.
39

RETURN

41       Returns the widget or gadget that contains the pointer when BSelect  is
42       released  or  a  key  is  released. If no widget or gadget contains the
43       pointer, the function returns NULL.
44
46       XmTrackingLocate(3).
47
48
49
50                                                 XmTrackingEvent(library call)
Impressum