XmDropSiteConfigureStackingOrder(3X)

     NAME
          XmDropSiteConfigureStackingOrder - A Drag and Drop function
          that reorders a stack of widgets that are registered drop
          sites

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

     VERSION
          This page documents Motif 2.1.

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