Click this button to go to the index for this section.

XmTrackingLocate(3X)
OSF/Motif


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.

SEE ALSO
  XmTrackingEvent(3X)