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

# XmCreateRadioBox(3)

A RowColumn widget convenience creation function

## NAME

**XmCreateRadioBox** — A RowColumn widget convenience creation function

## SYNOPSIS

```
#include <Xm/RowColumn.h>
Widget XmCreateRadioBox(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount);
```

## DESCRIPTION

**XmCreateRadioBox** creates an instance of a RowColumn widget of type **XmWORK\_AREA** and returns the associated widget ID. Typically, this is a composite widget that contains multiple ToggleButtonGadgets. The RadioBox arbitrates and ensures that at most one ToggleButtonGadget is on at any time.

Unless the application supplies other values in the *arglist*, this function provides initial values for several RowColumn resources. It initializes **XmNpacking** to **XmPACK\_COLUMN**, **XmNradioBehavior** to True, **XmNisHomogeneous** to True, and **XmNentryClass** to **XmToggleButtonGadgetClass**.

In a RadioBox, the ToggleButton or ToggleButtonGadget resource **XmNindicatorType** defaults to **XmONE\_OF\_MANY**, and the ToggleButton or ToggleButtonGadget resource**XmNvisibleWhenOff** defaults to True.

This routine is provided as a convenience function for creating RowColumn widgets.

- *parent*

  Specifies the parent widget ID

- *name*

  Specifies the name of the created widget

- *arglist*

  Specifies the argument list

- *argcount*

  Specifies the number of attribute/value pairs in the argument list (*arglist*)

For a complete definition of RowColumn and its associated resources, see [**XmRowColumn**(3)](/XmRowColumn/3.md).

## RETURN

Returns the RowColumn widget ID.

## RELATED

[**XmCreateRowColumn**(3)](/XmCreateRowColumn/3.md), [**XmCreateSimpleCheckBox**(3)](/XmCreateSimpleCheckBox/3.md), [**XmCreateSimpleRadioBox**(3)](/XmCreateSimpleRadioBox/3.md), [**XmCreateWorkArea**(3)](/XmCreateWorkArea/3.md), [**XmRowColumn**(3)](/XmRowColumn/3.md), [**XmVaCreateSimpleCheckBox**(3)](/XmVaCreateSimpleCheckBox/3.md), and [**XmVaCreateSimpleRadioBox**(3)](/XmVaCreateSimpleRadioBox/3.md).