


XmDragStart(3X)						      XmDragStart(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmDDrraaggSSttaarrtt -	A Drag and Drop	function that initiates	a drag and drop	tran-
  saction

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDrraaggDDrroopp..hh>>
  WWiiddggeett XXmmDDrraaggSSttaarrtt ((_w_i_d_g_e_t, _e_v_e_n_t, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
       WWiiddggeett	      _w_i_d_g_e_t;;
       XXEEvveenntt	      **_e_v_e_n_t;;
       AArrggLLiisstt	      _a_r_g_l_i_s_t;;
       CCaarrddiinnaall	      _a_r_g_c_o_u_n_t;;

DESCRIPTION
  XXmmDDrraaggSSttaarrtt initiates	a drag operation.  This	routine	returns	the DragCon-
  text widget that it initializes for the associated drag transaction.	The
  toolkit is responsible for freeing the DragContext when the drag and drop
  transaction is complete.

  _w_i_d_g_e_t Specifies the ID of the smallest widget and/or	gadget that encloses
	 the source elements selected for a drag operation.

  _e_v_e_n_t	 Specifies the XXEEvveenntt that triggered the drag operation.  This event
	 must be a ButtonPress event.

  _a_r_g_l_i_s_tSpecifies the argument	list.  Any XXmmDDrraaggCCoonntteexxtt resources not speci-
	 fied in the argument list are obtained	from the resource database or
	 are set to their default values.

  _a_r_g_c_o_u_n_t
	 Specifies the number of attribute/value pairs in the argument list
	 (_a_r_g_l_i_s_t)

  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	controls this drag and drop
  transaction.

RELATED	INFORMATION
  XXmmDDrraaggCCaanncceell((33XX)) and XXmmDDrraaggCCoonntteexxtt((33XX)).















