


XmTrackingLocate(3X)					 XmTrackingLocate(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTrraacckkiinnggLLooccaattee - A Toolkit function	that provides a	modal interaction

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  WWiiddggeett XXmmTTrraacckkiinnggLLooccaattee ((_w_i_d_g_e_t, _c_u_r_s_o_r, _c_o_n_f_i_n_e__t_o))
       WWiiddggeett	 _w_i_d_g_e_t;;
       CCuurrssoorr	 _c_u_r_s_o_r;;
       BBoooolleeaann	 _c_o_n_f_i_n_e__t_o;;

DESCRIPTION
  XXmmTTrraacckkiinnggLLooccaattee 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 BBSSeelleecctt is released or a key	is pressed
  and then released.  The function then	returns	the widget or gadget that
  contains the pointer when BBSSeelleecctt is released	or a key is released.

  This function	is obsolete and	exists for compatibility with previous
  releases.  It	has been replaced by XXmmTTrraacckkiinnggEEvveenntt.

  _w_i_d_g_e_t 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.

  _c_u_r_s_o_r Specifies the cursor to be used for the pointer during	the interac-
	 tion.	This is	a standard X cursor name.

  _c_o_n_f_i_n_e__t_o
	 Specifies whether or not the cursor should be confined	to _w_i_d_g_e_t

RETURN VALUE

  Returns the widget or	gadget that contains the pointer when BBSSeelleecctt is
  released or a	key is released.  If no	widget or gadget contains the
  pointer, the function	returns	NULL.

RELATED	INFORMATION
  XXmmTTrraacckkiinnggEEvveenntt((33XX)).


















