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, sibling, stack_mode)
          Widget      widget;
          Widget      sibling;
          Cardinal    stack_mode;


VERSION
     This page documents version 1.2 of the Motif library.

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.

     siblingSpecifies a sibling drop site for stacking  operations.   If  speci-
            fied,  then  widget  is restacked relative to this drop site's stack
            position.

     stack_mode
            Specifies the new stack position for the specified widget.  The val-
            ues 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 Xm-
     DropSite(3X).

RELATED INFORMATION
     XmDropSite(3X), XmDropSiteRetrieve(3X), and XmDropSiteQueryS-
     tackingOrder(3X).

                                            XmDropSiteConfigureStackingOrder(3X)