XmTrackingLocate(Xm)
XmTrackingLocate --
a Toolkit function that provides a modal interaction
Syntax
#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.
See also
XmTrackingEvent(Xm)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003