XmDropSiteQueryStackingOrder(3X)



SDK X11 R4.11MU05                           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;


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


Licensed material--property of copyright holder(s)
Museum
