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

# XmVaCreateSimpleRadioBox(3)

A RowColumn widget convenience creation function

## NAME

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

## SYNOPSIS

```
#include <Xm/RowColumn.h>
Widget XmVaCreateSimpleRadioBox(
Widget parent,
String name,
int button_set,
XtCallbackProc callback);
```

## DESCRIPTION

**XmVaCreateSimpleRadioBox** creates an instance of a RowColumn widget of type **XmWORK\_AREA** and returns the associated widget ID. This routine uses the ANSI C variable-length argument list (*varargs*) calling convention.

This routine creates a RadioBox and its ToggleButtonGadget children. The name of each button is **button\_***n*, where *n* is an integer from 0 (zero) to the number of buttons in the menu minus 1.

- *parent*

  Specifies the parent widget ID.

- *name*

  Specifies the name of the created widget.

- *button\_set*

  Specifies which button is initially set. The value is the integer *n* in the button name **button\_***n*.

- *callback*

  Specifies a callback procedure to be called when a button's value changes. This callback function is added to each button after creation as the button's **XmNvalueChangedCallback**. The callback function is called when a button's value changes, and the button number is returned in the *client\_data* field.

The variable portion of the argument list consists of groups of arguments. The first argument in each group is a constant or a string and determines which arguments follow in that group. The last argument in the list must be NULL. Following are the possible first arguments in each group of *varargs*:

- **XmVaRADIOBUTTON**

  This is followed by four additional arguments. The set specifies one button in the RadioBox and some of its resource values. Following are the additional four arguments, in order:

  - *label*

    The label string, of type **XmString**.

  - *mnemonic*

    The mnemonic, of type **KeySym**. This is ignored in this release.

  - *accelerator*

    The accelerator, of type **String**. This is ignored in this release.

  - *accelerator\_text*

    The accelerator text, of type **XmString**. This is ignored in this release.

- *resource\_name*

  This is followed by one additional argument, the value of the resource, of type **XtArgVal**. The pair specifies a resource and its value for the RowColumn widget.

- **XtVaTypedArg**

  This is followed by four additional arguments. The set specifies a resource and its value for the RowColumn widget. A resource type conversion is performed if necessary. Following are the additional four arguments, in this order:

  - *name*

    The resource name, of type **String**

  - *type*

    The type of the resource value supplied, of type **String**

  - *value*

    The resource value (or a pointer to the resource value, depending on the type and size of the value), of type **XtArgVal**

  - *size*

    The size of the resource value in bytes, of type *int*

- **XtVaNestedList**

  This is followed by one additional argument of type **XtVarArgsList**. This argument is a nested list of *varargs* returned by **XtVaCreateArgsList**.

For more information on variable-length argument lists, see the X Toolkit Intrinsics documentation.

A number of resources exist specifically for use with this and other simple menu creation routines. For a complete definition of RowColumn and its associated resources, see [**XmRowColumn**(3)](/XmRowColumn/3.md).

## RETURN

Returns the RowColumn widget ID.

## RELATED

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