1XmDropSiteQueryStackingOrder(libraryXcmaDlrlo)pSiteQueryStackingOrder(library call)
2
3
4
6 XmDropSiteQueryStackingOrder — A Drag and Drop function that returns
7 the parent, a list of children, and the number of children for a speci‐
8 fied widget
9
11 #include <Xm/DragDrop.h>
12 Status XmDropSiteQueryStackingOrder(
13 Widget widget,
14 Widget *parent_return,
15 Widget **child_returns,
16 Cardinal *num_child_returns);
17
19 XmDropSiteQueryStackingOrder obtains the parent, a list of children
20 registered as drop sites, and the number of children registered as drop
21 sites for a given widget. The children are listed in current stacking
22 order, from bottom-most (first child) to the top-most (last child).
23 This function allocates memory for the returned data that must be freed
24 by calling XtFree.
25
26 widget Specifies the widget ID. For this widget, you obtain the list
27 of its children, its parent, and the number of children.
28
29 parent_return
30 Returns the widget ID of the drop site parent of the speci‐
31 fied widget.
32
33 child_returns
34 Returns a pointer to the list of drop site children associ‐
35 ated with the specified widget. The function allocates mem‐
36 ory to hold the list. The application is responsible for
37 managing the allocated space. The application can recover
38 the allocated space by calling XtFree.
39
40 num_child_returns
41 Returns the number of drop site children for the specified
42 widget.
43
44 For a complete definition of DropSite and its associated resources, see
45 XmDropSite(3).
46
48 Returns 0 (zero) if the routine fails; returns a nonzero value if it
49 succeeds.
50
52 XmDropSite(3) and XmDropSiteConfigureStackingOrder(3).
53
54
55
56 XmDropSiteQueryStackingOrder(library call)