---
name: "XmContainerGetItemChildren"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmContainerGetItemChildren"
---

# XmContainerGetItemChildren(3)

Container widget function to find all children of an item

## 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)](/XmContainer/3.md).

## RETURN

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

## RELATED

[**XmContainer**(3)](/XmContainer/3.md).