NAME¶

XmContainerGetItemChildren — Container widget function to find all children of an item

SYNOPSIS¶

#include <Xm/Container.h>
int XmContainerGetItemChildren(
Widget container,
Widget item,
WidgetList * item_children);

DESCRIPTION¶

XmContainerGetItemChildren allocates a WidgetList and stores within it the widget IDs of all widgets that have item specified as the value of their XmNentryParent resource. The application programmer is responsible for freeing the allocated WidgetList using XtFree. The number of widget IDs returned in item_children is returned by the function. If no widgets specify item as the value of their XmNentryParent resource, the function returns zero and item_children is left unchanged.

container

Specifies the Container widget ID.

item

Specifies a widgetID within container.

item_children

Returned array of Widgets.

For a complete definition of Container and its associated resources, see XmContainer(3).

RETURN¶

This function returns a count of all widgets that have item specified as the value of their XmNentryParent resource.

RELATED¶

XmContainer(3).