XmDropSiteConfigureStackingOrder(Xm) XmDropSiteConfigureStackingOrder(Xm)
6 January 1993
Name
XmDropSiteConfigureStackingOrder - a Drag and Drop function that reorders
a stack of widgets that are registered drop sites
Syntax
#include <Xm/DragDrop.h>
void XmDropSiteConfigureStackingOrder (widget, sibling, stack_mode)
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 speci-
fied, then widget is restacked relative to this drop site's stack
position.
stackmode
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 res-
tacked 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(Xm).
See also
XmDropSite(Xm), XmDropSiteRetrieve(Xm) and
XmDropSiteQueryStackingOrder(Xm).