Museum

 XmDropSiteQueryStackingOrder(Xm)            XmDropSiteQueryStackingOrder(Xm)
                                6 January 1993


 Name

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

 Syntax


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

    parentreturn
            Returns the widget ID of the drop site parent of the specified
            widget.

    childreturns
            Returns a pointer to the list of drop site children associated
            with the specified widget.

    numchildreturns
            Returns the number of drop site children for the specified
            widget.

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

 Return value

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

 See also

    XmDropSite(Xm) and XmDropSiteConfigureStackingOrder(Xm).