XmDropSiteQueryStackingOrder(X3mot)

XmDropSiteQueryStackingOrder -- a Drag and Drop function that returns the parent, a list of children, and the number of children for a specified widget

Synopsis

#include <Xm/DragDrop.h>

Status XmDropSiteQueryStackingOrder (widget, parent_return,
                                     child_returns, num_child_returns)
Widget  widget;
Widget  *parent_return;
Widget  **child_returns;
Cardinal *num_child_returns;

Description

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.

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.
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(X3mot).

Return values

Returns zero if the routine fails; returns a nonzero value if it succeeds.

References

XmDropSite(X3mot) and XmDropSiteConfigureStackingOrder(X3mot).