XmDropSiteQueryStackingOrder(3X)										  XmDropSiteQueryStackingOrder(3X)

NAME

       XmDropSiteQueryStackingOrder - A Drag and Drop function that returns the parent, a list of children, and the number of children for a spec-
       ified 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.  Specifies the widget ID.  For this widget,  you
       obtain  the  list  of its children, its parent, and the number of children.  Returns the widget ID of the drop site parent of the specified
       widget.	Returns a pointer to the list of drop site children associated with the specified widget.  Returns the number of drop  site  chil-
       dren 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.

SEE ALSO

       XmDropSite(3X), XmDropSiteConfigureStackingOrder(3X)

														  XmDropSiteQueryStackingOrder(3X)