NAME

       XmDropSiteConfigureStackingOrder  —  A  Drag  and  Drop  function that reorders a stack of
       widgets that are registered drop sites "XmDropSiteConfigureStack\%ingOrder" "Drag and Drop
       functions" "XmDropSiteConfigureStack\%ingOrder"

SYNOPSIS

       #include <Xm/DragDrop.h>
       void XmDropSiteConfigureStackingOrder(
       Widget widget,
       Widget sibling,
       Cardinal stack_mode);

DESCRIPTION

       XmDropSiteConfigureStackingOrder  changes the stacking order of the drop site specified by
       widget. 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.

       widget    Specifies the drop site to be restacked.

       sibling   Specifies a sibling drop site for stacking operations. If specified, then widget
                 is restacked relative to this drop site's stack position.

       stack_mode
                 Specifies  the  new  stack  position  for  the specified widget.  The values are
                 XmABOVE and XmBELOW. If a sibling is specified,  then  widget  is  restacked  as
                 follows:

                 XmABOVE   The widget is placed just above the sibling.

                 XmBELOW   The widget is placed just below the sibling.

                 If the sibling parameter is not specified, then widget is restacked as follows:

                 XmABOVE   The widget is placed at the top of the stack.

                 XmBELOW   The widget is placed at the bottom of the stack.

       For a complete definition of DropSite and its associated resources, see XmDropSite(3).

RELATED

       XmDropSite(3), XmDropSiteRetrieve(3), and XmDropSiteQueryStackingOrder(3).

                                                              XmDropSiteConfigureStackingOrder(3)