DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmDropSiteQueryStackingOrder(Xm)


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.

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

Return value

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

See also

XmDropSite(Xm) and XmDropSiteConfigureStackingOrder(Xm).


© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003