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

# XmCreateSelectionBox(3)

The SelectionBox widget creation function

## NAME

**XmCreateSelectionBox** — The SelectionBox widget creation function

## SYNOPSIS

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

## DESCRIPTION

**XmCreateSelectionBox** creates an unmanaged SelectionBox. A SelectionBox is used to get a selection from a list of alternatives from the user and includes the following:

- •

  A scrolling list of alternatives

- •

  An editable text field for the selected alternative

- •

  Labels for the list and text field

- •

  Three or four buttons

The default button labels are **OK**, **Cancel**, and **Help**. By default, an **Apply** button is also created. If the parent of the SelectionBox is a DialogShell, it is managed; otherwise it is unmanaged. Additional work area children may be added to the SelectionBox after creation.

- *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 SelectionBox and its associated resources, see [**XmSelectionBox**(3)](/XmSelectionBox/3.md).

## RETURN

Returns the SelectionBox widget ID.

## RELATED

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