---
name: "wxSingleChoiceDialog"
section: "3erl"
platform: "linux"
package: "erlang-manpages"
version: "1:25.2.3+dfsg-1+deb12u4"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/wxSingleChoiceDialog"
---

# wxSingleChoiceDialog(3erl)

Functions for wxSingleChoiceDialog class

## NAME

wxSingleChoiceDialog - Functions for wxSingleChoiceDialog class

## DESCRIPTION

This class represents a dialog that shows a list of strings, and allows the user to select one. Double-clicking on a list item is equivalent to single-clicking and then pressing OK.

Styles

This class supports the following styles:

See: Overview cmndlg, *wxMultiChoiceDialog*

This class is derived (and can use functions) from: *wxDialog* *wxTopLevelWindow* *wxWindow* *wxEvtHandler*

wxWidgets docs: wxSingleChoiceDialog

## DATA TYPES

```
wxSingleChoiceDialog() = wx:wx_object()
```

## EXPORTS

```
new(Parent, Message, Caption, Choices) -> wxSingleChoiceDialog()
```

Types:

Parent = wxWindow:wxWindow()\
 Message = Caption = unicode:chardata()\
 Choices = \[unicode:chardata()\]\

```
new(Parent, Message, Caption, Choices, Options :: [Option]) ->
       wxSingleChoiceDialog()
```

Types:

Parent = wxWindow:wxWindow()\
 Message = Caption = unicode:chardata()\
 Choices = \[unicode:chardata()\]\
 Option = \
\
     {style, integer()} \| {pos, {X :: integer(), Y :: integer()}}\

Constructor, taking an array of *wxString* (not implemented in wx) choices and optional client data.

Remark: Use *wxDialog:showModal/1* to show the dialog.

```
getSelection(This) -> integer()
```

Types:

This = wxSingleChoiceDialog()\

Returns the index of selected item.

```
getStringSelection(This) -> unicode:charlist()
```

Types:

This = wxSingleChoiceDialog()\

Returns the selected string.

```
setSelection(This, Selection) -> ok
```

Types:

This = wxSingleChoiceDialog()\
 Selection = integer()\

Sets the index of the initially selected item.

```
destroy(This :: wxSingleChoiceDialog()) -> ok
```

Destroys the object.