<!-- $XConsortium: DropSitC.sgm /main/8 1996/09/08 20:40:57 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN212.rsml.1">
<RefMeta>
<RefEntryTitle>XmDropSiteConfigureStackingOrder</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmDropSiteConfigureStackingOrder</Function></RefName>
<RefPurpose>A Drag and Drop function that
reorders a stack of widgets that are registered drop sites
<IndexTerm>
<Primary>XmDropSiteConfigureStack\\%ingOrder</Primary>
</IndexTerm><IndexTerm>
<Primary>Drag and Drop functions</Primary>
<Secondary>XmDropSiteConfigureStack\\%ingOrder</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/DragDrop.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmDropSiteConfigureStackingOrder</Function></FuncDef>
<!--<ParamDef><Replaceable>widget, sibling, stack_mode</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>Widget <Parameter>sibling</Parameter></ParamDef>
<ParamDef>Cardinal <Parameter>stack_mode</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmDropSiteConfigureStackingOrder</Function> changes the stacking
order of the drop site specified by <Symbol Role="Variable">widget</Symbol>. 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.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">widget</Symbol></Term>
<ListItem>
<Para>Specifies the drop site to be restacked.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">sibling</Symbol></Term>
<ListItem>
<Para>Specifies a sibling drop site for stacking operations. If specified,
then <Symbol Role="Variable">widget</Symbol> is restacked relative to this drop site's stack position.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">stack_mode</Symbol></Term>
<ListItem>
<Para>Specifies the new stack position for the specified widget.
The values are <SystemItem Class="Constant">XmABOVE</SystemItem> and <SystemItem Class="Constant">XmBELOW</SystemItem>. If a sibling is specified,
then <Symbol Role="Variable">widget</Symbol> is restacked as follows:
</Para>
<VariableList>
<VarListEntry>
<Term><SystemItem Class="Constant">XmABOVE</SystemItem></Term>
<ListItem>
<Para>The widget is placed just above the sibling.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Constant">XmBELOW</SystemItem></Term>
<ListItem>
<Para>The widget is placed just below the sibling.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>If the <Symbol Role="Variable">sibling</Symbol> parameter is not specified, then <Symbol Role="Variable">widget</Symbol>
is restacked as follows:
</Para>
<VariableList>
<VarListEntry>
<Term><SystemItem Class="Constant">XmABOVE</SystemItem></Term>
<ListItem>
<Para>The widget is placed at the top of the stack.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Constant">XmBELOW</SystemItem></Term>
<ListItem>
<Para>The widget is placed at the bottom of the stack.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of DropSite and its associated resources,
see &cdeman.XmDropSite;.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmDropSite;,
&cdeman.XmDropSiteRetrieve;, and
&cdeman.XmDropSiteQueryStackingOrder;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
