


XmGetDragContext(3X)					 XmGetDragContext(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmGGeettDDrraaggCCoonntteexxtt - A Drag and	Drop function that retrieves the DragContext
  widget ID associated with a timestamp

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDrraaggCC..hh>>
  WWiiddggeett XXmmGGeettDDrraaggCCoonntteexxtt ((_r_e_f_w_i_d_g_e_t, _t_i_m_e_s_t_a_m_p))
       WWiiddggeett	   _r_e_f_w_i_d_g_e_t;;
       TTiimmee	   _t_i_m_e_s_t_a_m_p;;

DESCRIPTION
  XXmmGGeettDDrraaggCCoonntteexxtt returns the widget ID of the	active DragContext associated
  with a given display and timestamp.  A timestamp uniquely identifies which
  DragContext is active	when more than one drag	and drop transaction has been
  initiated on a display.  If the specified timestamp matches a	timestamp
  processed between the	start and finish of a single drag and drop transac-
  tion,	the function returns the corresponding DragContext ID.

  _r_e_f_w_i_d_g_e_t
	 Specifies the ID of the widget	that the routine uses to identify the
	 intended display.  The	function returns the ID	of the DragContext
	 associated with the display value passed by this widget.

  _t_i_m_e_s_t_a_m_p
	 Specifies a timestamp.

  For a	complete definition of DragContext and its associated resources, see
  XXmmDDrraaggCCoonntteexxtt((33XX)).

RETURN VALUE
  Returns the ID of the	DragContext widget that	is active for the specified
  timestamp.  Otherwise, returns NULL if no active DragContext is found.

RELATED	INFORMATION
  XXmmDDrraaggCCoonntteexxtt((33XX)).





















