


XmTrackingEvent(3X)					  XmTrackingEvent(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTrraacckkiinnggEEvveenntt - 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gEEvveenntt ((_w_i_d_g_e_t, _c_u_r_s_o_r, _c_o_n_f_i_n_e__t_o, _e_v_e_n_t__r_e_t_u_r_n))
       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;;
       XXEEvveenntt	 **_e_v_e_n_t__r_e_t_u_r_n;;

DESCRIPTION
  XXmmTTrraacckkiinnggEEvveenntt 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 con-
  tains	the pointer when BBSSeelleecctt is released or	a key is released.

  _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.

  _e_v_e_n_t__r_e_t_u_r_n
	 Returns the ButtonRelease or KeyRelease event that causes the func-
	 tion to return.

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gLLooccaattee((33XX)).

















