NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       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
       children for the specified widget.

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

RETURN VALUE    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       XmDropSite(3X), XmDropSiteConfigureStackingOrder(3X)



                                 XmDropSiteQueryStackingOrder(3X)