XMDROPSITEQUERYSTACKINGORDER(3)

✨ XmDropSiteQueryStackingOrder(3) ✨

okay so bestie, this is the manual page for XmDropSiteQueryStackingOrder(3) from the library call manual. It's literally a Drag and Drop function, and it's here to hand you the parent, a list of children, and the number of children for a specified widget. 💅

🌸 NAME 🌸

XmDropSiteQueryStackingOrder — A Drag and Drop function that returns the parent, a list of children, and the number of children for a specified widget. periodt.

✨ SYNOPSIS ✨

#include <Xm/DragDrop.h>
Status XmDropSiteQueryStackingOrder(
       Widget widget,
       Widget *parent_return,
       Widget **child_returns,
       Cardinal *num_child_returns);

💖 DESCRIPTION 💖

So XmDropSiteQueryStackingOrder obtains the parent, a list of children registered as drop sites, and the number of children registered as drop sites for a given widget. The children are listed in current stacking order, from bottom-most (first child) to the top-most (last child). This function allocates memory for the returned data that must be freed by calling XtFree. no cap, you gotta free it. 🫶

Here are the args, bestie:

• widget — Specifies the widget ID. For this widget, you obtain the list of its children, its parent, and the number of children. 💖
• parent_return — Returns the widget ID of the drop site parent of the specified widget. 👑
• child_returns — Returns a pointer to the list of drop site children associated with the specified widget. The function allocates memory to hold the list. The application is responsible for managing the allocated space. The application can recover the allocated space by calling XtFree. 🧚
• num_child_returns — Returns the number of drop site children for the specified widget. 🔢

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

🔥 RETURN 🔥

Returns 0 (zero) if the routine fails; returns a nonzero value if it succeeds. so like, zero is the fail vibe, nonzero is the slay. 💀✨

🫶 RELATED 🫶

XmDropSite(3) and XmDropSiteConfigureStackingOrder(3).

And that's the tea! This page's footer says it's from the library call manual; no date is printed, but the source/version is library call and the vibe is timeless. stay iconic, bestie. 💖✨