XMDROPSITECONFIGURESTACKINGORDER(3)

💅 NAME 💅

XmDropSiteConfigureStackingOrder — a Drag and Drop function that reorders a stack of widgets that are registered drop sites ✨

(this one lives in the library call manual, bestie — XmDropSiteC...ackingOrder, you know the one 🫶)

---

🎀 SYNOPSIS 🎀

#include <Xm/DragDrop.h>
void XmDropSiteConfigureStackingOrder(
Widget widget,
Widget sibling,
Cardinal stack_mode);

---

🦋 DESCRIPTION 🦋

okay so XmDropSiteConfigureStackingOrder changes the stacking order of the drop site specified by widget. 💫

and like… why do we care? because the stacking order is literally what controls the manner in which drag-under effects are clipped by overlapping siblings, regardless of whether they are active. yes, even the inactive ones. the audacity, honestly 😭

the stack mode is relative either to the entire stack, or to another drop site within the stack — dealer's choice.

⚠️ but bestie, hear me: 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. no siblings, no composite parent, no restacking. periodt. 💀

• widget — specifies the drop site to be restacked. that's the one getting its glow-up ✨
• sibling — specifies a sibling drop site for stacking operations. if you specify it, then widget is restacked relative to this drop site's stack position. it's giving "you're standing next to your friend now" energy 🫶
• stack_mode — specifies the new stack position for the specified widget. the values are XmABOVE and XmBELOW. here's the tea 🍓

if a sibling is specified, then widget is restacked like this:

• 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 like this instead:

• XmABOVE — the widget is placed at the top of the stack. main character energy fr fr 🌟
• XmBELOW — the widget is placed at the bottom of the stack. humble era, we love to see it 🌸

for a complete definition of DropSite and its associated resources, see XmDropSite(3). iykyk 💜

---

🌈 RELATED 🌈

XmDropSite(3), XmDropSiteRetrieve(3), and XmDropSiteQueryStackingOrder(3).

go read those too, they're iconic, no cap 📚✨

---

and that's the whole page, bestie!! 💖 this was XmDropSiteC...ackingOrder from the library call manual — the footer's little signature says so, no date drama attached, just pure library-call realness. 🎀🦋 slay responsibly 🫶