DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmDropSiteConfigureStackingOrder(Xm)


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 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:

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

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

See also

XmDropSite(Xm), XmDropSiteRetrieve(Xm) and XmDropSiteQueryStackingOrder(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003