XmDropSiteQueryStackingOrder(3X)
Prev | Reference Pages | Next

## Name

XmDropSiteQueryStackingOrder(3X) — XmDropSiteQueryStackingOrder--A Drag and Drop function that returns the parent, a list of children, and the number of children for a specified widget XmDropSiteQueryStackingOrderDrag and Drop functions

## 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(3X).

## RETURN VALUE

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

## RELATED INFORMATION

XmDropSite(3X) and XmDropSiteConfigureStackingOrder(3X).

Prev | Table of Contents | Next
XmDropSiteEndUpdate(3X) |  | XmDropSiteRegister(3X)