


XmDropSiteConfigureStackingOrder(3X)	 XmDropSiteConfigureStackingOrder(3X)
OSF/Motif							    OSF/Motif



NAME
  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 - A Drag and	Drop function that  reorders
  a stack of widgets that are registered drop sites

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDrraaggDDrroopp..hh>>
  vvooiidd 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	((_w_i_d_g_e_t, _s_i_b_l_i_n_g, _s_t_a_c_k__m_o_d_e))
       WWiiddggeett	   _w_i_d_g_e_t;;
       WWiiddggeett	   _s_i_b_l_i_n_g;;
       CCaarrddiinnaall	   _s_t_a_c_k__m_o_d_e;;

DESCRIPTION
  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 changes the stacking	order of the drop
  site specified by _w_i_d_g_e_t.  The stacking order	controls the manner in which
  drag-under effects are clipped by overlapping	siblings, regardless of
  whether they are active.  The	stack mode is relative either to the entire
  stack, or to another drop site within	the stack.  The	stack order can	be
  modified only	if the drop sites are siblings in both the widget and drop
  site hierarchy, and the widget parent	of the drop sites is registered	as a
  composite drop site.

  _w_i_d_g_e_t Specifies the drop site to be restacked.

  _s_i_b_l_i_n_gSpecifies a sibling drop site for stacking operations.	 If speci-
	 fied, then _w_i_d_g_e_t is restacked	relative to this drop site's stack
	 position.

  _s_t_a_c_k__m_o_d_e
	 Specifies the new stack position for the specified widget.  The
	 values	are XXmmAABBOOVVEE and	XXmmBBEELLOOWW.  If a sibling is specified, then
	 _w_i_d_g_e_t	is restacked as	follows:

	 XXmmAABBOOVVEE
	    The	widget is placed just above the	sibling.

	 XXmmBBEELLOOWW
	    The	widget is placed just below the	sibling.
  If the _s_i_b_l_i_n_g parameter is not specified, then _w_i_d_g_e_t is restacked as fol-
  lows:

	 XXmmAABBOOVVEE
	    The	widget is placed at the	top of the stack.

	 XXmmBBEELLOOWW
	    The	widget is placed at the	bottom of the stack.

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


RELATED	INFORMATION
  XXmmDDrrooppSSiittee((33XX)), XXmmDDrrooppSSiitteeRReettrriieevvee((33XX)), and
  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((33XX)).



