XmDropSiteQueryStackingOrder(3X)

     NAME
          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;


     VERSION
          This page documents version 1.2 of the Motif library.

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