


XmDropSiteQueryStackingOrder(3X)	     XmDropSiteQueryStackingOrder(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmDDrrooppSSiitteeQQuueerryySSttaacckkiinnggOOrrddeerr - A Drag	and Drop function that	returns	the
  parent, a list of children, and the number of	children for a specified
  widget

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDrraaggDDrroopp..hh>>
  SSttaattuuss XXmmDDrrooppSSiitteeQQuueerryySSttaacckkiinnggOOrrddeerr ((_w_i_d_g_e_t, _p_a_r_e_n_t__r_e_t_u_r_n,
	  _c_h_i_l_d__r_e_t_u_r_n_s, _n_u_m__c_h_i_l_d__r_e_t_u_r_n_s))
       WWiiddggeett	   _w_i_d_g_e_t;;
       WWiiddggeett	   **_p_a_r_e_n_t__r_e_t_u_r_n;;
       WWiiddggeett	   ****_c_h_i_l_d__r_e_t_u_r_n_s;;
       CCaarrddiinnaall	   **_n_u_m__c_h_i_l_d__r_e_t_u_r_n_s;;

DESCRIPTION
  XXmmDDrrooppSSiitteeQQuueerryySSttaacckkiinnggOOrrddeerr obtains the parent, a list of children
  registered as	drop sites, and	the number of children registered as drop
  sites	for a given widget.  The children are listed in	current	stacking
  order, from bottom-most (first child)	to the top-most	(last child).  This
  function allocates memory for	the returned data that must be freed by	cal-
  ling XXttFFrreeee.

  _w_i_d_g_e_t Specifies the widget ID.  For this widget, you	obtain the list	of
	 its children, its parent, and the number of children.

  _p_a_r_e_n_t__r_e_t_u_r_n
	 Returns the widget ID of the drop site	parent of the specified
	 widget.

  _c_h_i_l_d__r_e_t_u_r_n_s
	 Returns a pointer to the list of drop site children associated	with
	 the specified widget.

  _n_u_m__c_h_i_l_d__r_e_t_u_r_n_s
	 Returns the number of drop site children for the specified widget.

  For a	complete definition of DropSite	and its	associated resources, see
  XXmmDDrrooppSSiittee((33XX)).

RETURN VALUE
  Returns zero if the routine fails; returns a nonzero value if	it succeeds.

RELATED	INFORMATION
  XXmmDDrrooppSSiittee((33XX)) and XXmmDDrrooppSSiitteeCCoonnffiigguurreeSSttaacckkiinnggOOrrddeerr((33XX)).












