xmdropsitequerystackingorder(3) [redhat man page]

XmDropSiteQueryStackingOrder(library call)								XmDropSiteQueryStackingOrder(library call)

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 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.  The function allocates memory to  hold
		 the  list.   The application is responsible for managing the allocated space.	The application can recover the allocated space by
		 calling XtFree.

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

RETURN

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

RELATED

       XmDropSite(3) and XmDropSiteConfigureStackingOrder(3).

													XmDropSiteQueryStackingOrder(library call)

XmDropSiteConfigureStackingOrder(library call)							    XmDropSiteConfigureStackingOrder(library call)

NAME

       XmDropSiteConfigureStackingOrder -- A Drag and Drop function that reorders a stack of widgets that are registered drop sites

SYNOPSIS

       #include <Xm/DragDrop.h>
       void XmDropSiteConfigureStackingOrder(
       Widget widget,
       Widget sibling,
       Cardinal stack_mode);

DESCRIPTION

       XmDropSiteConfigureStackingOrder changes the stacking order of the drop site specified by widget. The stacking order controls the manner in
       which drag-under effects are clipped by overlapping siblings, regardless of whether they are active. The stack mode is relative	either	to
       the entire stack, or to another drop site within the stack. The stack order can be modified only if the drop sites are siblings in both the
       widget and drop site hierarchy, and the widget parent of the drop sites is registered as a composite drop site.

       widget	 Specifies the drop site to be restacked.

       sibling	 Specifies a sibling drop site for stacking operations. If specified, then widget is restacked relative to this drop site's  stack
		 position.

       stack_mode
		 Specifies  the  new stack position for the specified widget.  The values are XmABOVE and XmBELOW. If a sibling is specified, then
		 widget is restacked as follows:

		 XmABOVE   The widget is placed just above the sibling.

		 XmBELOW   The widget is placed just below the sibling.

		 If the sibling parameter is not specified, then widget is restacked as follows:

		 XmABOVE   The widget is placed at the top of the stack.

		 XmBELOW   The widget is placed at the bottom of the stack.

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

RELATED

       XmDropSite(3), XmDropSiteRetrieve(3), and XmDropSiteQueryStackingOrder(3).

												    XmDropSiteConfigureStackingOrder(library call)