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 wid-
     get

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  regis-
     tered  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 wid-
            get.

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

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

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

                                                XmDropSiteQueryStackingOrder(3X)