XmTrackingEvent(3X)
Prev | Reference Pages | Next

## Name

XmTrackingEvent(3X) — XmTrackingEvent--A Toolkit function that provides a modal interaction XmTrackingEventToolkit functions

## Synopsis

#include <Xm/Xm.h>
Widget XmTrackingEvent (`widget, cursor, confine_to, event_return`)
Widget `widget`;
Cursor `cursor`;
Boolean `confine_to`;
XEvent `*event_return`;

## 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.
`confine_to` |  | Specifies whether or not the cursor should be confined to `widget`.
`event_return` |  | 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).

Prev | Table of Contents | Next
XmToggleButtonSetState(3X) |  | XmTrackingLocate(3X)