'\" t
.\" DropSitC.sgm /main/8 1996/09/08 20:40:57 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmDropSiteConfigureStackingOrder" 3
.SH "NAME"
\fBXmDropSiteConfigureStackingOrder\fP \(em A Drag and Drop function that
reorders a stack of widgets that are registered drop sites
"XmDropSiteConfigureStack\\%ingOrder"
"Drag and Drop functions" "XmDropSiteConfigureStack\\%ingOrder"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/DragDrop\&.h>
\fBvoid \fBXmDropSiteConfigureStackingOrder\fP\fR(
\fBWidget \fBwidget\fR\fR,
\fBWidget \fBsibling\fR\fR,
\fBCardinal \fBstack_mode\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmDropSiteConfigureStackingOrder\fP changes the stacking
order of the drop site specified by \fIwidget\fP\&. 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\&.
.IP "\fIwidget\fP" 10
Specifies the drop site to be restacked\&.
.IP "\fIsibling\fP" 10
Specifies a sibling drop site for stacking operations\&. If specified,
then \fIwidget\fP is restacked relative to this drop site\&'s stack position\&.
.IP "\fIstack_mode\fP" 10
Specifies the new stack position for the specified widget\&.
The values are \fBXmABOVE\fP and \fBXmBELOW\fP\&. If a sibling is specified,
then \fIwidget\fP is restacked as follows:
.RS
.IP "\fBXmABOVE\fP" 10
The widget is placed just above the sibling\&.
.IP "\fBXmBELOW\fP" 10
The widget is placed just below the sibling\&.
.RE
.IP "" 10
If the \fIsibling\fP parameter is not specified, then \fIwidget\fP
is restacked as follows:
.RS
.IP "\fBXmABOVE\fP" 10
The widget is placed at the top of the stack\&.
.IP "\fBXmBELOW\fP" 10
The widget is placed at the bottom of the stack\&.
.RE
.PP
For a complete definition of DropSite and its associated resources,
see \fBXmDropSite\fP(3)\&.
.SH "RELATED"
.PP
\fBXmDropSite\fP(3),
\fBXmDropSiteRetrieve\fP(3), and
\fBXmDropSiteQueryStackingOrder\fP(3)\&.
.\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:22