wxRadioBox(3erl)

NAME 🎀

okay so this is the wxRadioBox(3erl) page—Erlang module definition energy—and the name is wxRadioBox: Functions for wxRadioBox class.

DESCRIPTION 💅

A radio box item is used to select one of number of mutually exclusive choices. It is displayed as a vertical column or horizontal row of labelled buttons.

Styles ✨

This class supports the following styles:

bestie, the original list is literally empty here. That's the whole tea. 🫖

See: Overview events, wxRadioButton, wxCheckBox

This class is derived (and can use functions) from: wxControl wxWindow wxEvtHandler

wxWidgets docs: wxRadioBox

EVENTS 🎉

Event types emitted from this class: command_radiobox_selected

DATA TYPES 🧬

wxRadioBox() = wx:wx_object()

EXPORTS 👑

new(Parent, Id, Label, Pos, Size, Choices) -> wxRadioBox()

Types:

Parent = wxWindow:wxWindow()
Id = integer()
Label = unicode:chardata()
Pos = {X :: integer(), Y :: integer()}
Size = {W :: integer(), H :: integer()}
Choices = [unicode:chardata()]

new(Parent, Id, Label, Pos, Size, Choices, Options :: [Option]) -> wxRadioBox()

Types:

Parent = wxWindow:wxWindow()
Id = integer()
Label = unicode:chardata()
Pos = {X :: integer(), Y :: integer()}
Size = {W :: integer(), H :: integer()}
Choices = [unicode:chardata()]
Option =
    {majorDim, integer()} |
    {style, integer()} |
    {val, wx:wx_object()}

Constructor, creating and showing a radiobox. iconic constructor behavior, no notes. 💖

See: create/8, wxValidator (not implemented in wx)

destroy(This :: wxRadioBox()) -> ok

Destructor, destroying the radiobox item. bye bestie 👋

create(This, Parent, Id, Label, Pos, Size, Choices) -> boolean()

Types:

This = wxRadioBox()
Parent = wxWindow:wxWindow()
Id = integer()
Label = unicode:chardata()
Pos = {X :: integer(), Y :: integer()}
Size = {W :: integer(), H :: integer()}
Choices = [unicode:chardata()]

create(This, Parent, Id, Label, Pos, Size, Choices, Options :: [Option]) -> boolean()

Types:

This = wxRadioBox()
Parent = wxWindow:wxWindow()
Id = integer()
Label = unicode:chardata()
Pos = {X :: integer(), Y :: integer()}
Size = {W :: integer(), H :: integer()}
Choices = [unicode:chardata()]
Option =
    {majorDim, integer()} |
    {style, integer()} |
    {val, wx:wx_object()}

Creates the radiobox for two-step construction. two-step construction is giving main character energy. ✨

See new/7 for further details.

enable(This) -> boolean()

Types:

This = wxRadioBox()

enable(This, N) -> boolean()

enable(This, N) -> boolean()

enable(This, N :: [Option]) -> boolean()

Types:

This = wxRadioBox()
Option = {enable, boolean()}

Enables or disables the radiobox.

See: wxWindow:enable/2

enable(This, N, Options :: [Option]) -> boolean()

Types:

This = wxRadioBox()
N = integer()
Option = {enable, boolean()}

Enables or disables an individual button in the radiobox. one button at a time, very demure.

See: wxWindow:enable/2

getSelection(This) -> integer()

Types:

This = wxRadioBox()

Returns the index of the selected item or wxNOT_FOUND if no item is selected.

Return: The position of the current selection.

Remark: This method can be used with single selection list boxes only, you should use wxListBox:getSelections/1 for the list boxes with wxLB_MULTIPLE style.

See: setSelection/2, wxControlWithItems:getStringSelection/1

getString(This, N) -> unicode:charlist()

Types:

This = wxRadioBox()
N = integer()

Returns the label of the item with the given index.

Return: The label of the item or an empty string if the position was invalid.

setSelection(This, N) -> ok

Types:

This = wxRadioBox()
N = integer()

Sets the selection to the given item.

Notice that a radio box always has selection, so n must be valid here and passing wxNOT_FOUND is not allowed. like, do not try it bestie 😭

show(This, Item) -> boolean()

Types:

This = wxRadioBox()
Item = integer()

show(This, Item, Options :: [Option]) -> boolean()

Types:

This = wxRadioBox()
Item = integer()
Option = {show, boolean()}

Shows or hides individual buttons. peekaboo but make it GUI. 🦋

Return: true if the item has been shown or hidden or false if nothing was done because it already was in the requested state.

See: show/3

getColumnCount(This) -> integer()

Types:

This = wxRadioBox()

Returns the number of columns in the radiobox.

getItemHelpText(This, Item) -> unicode:charlist()

Types:

This = wxRadioBox()
Item = integer()

Returns the helptext associated with the specified item if any or wxEmptyString.

See: setItemHelpText/3

getItemToolTip(This, Item) -> wxToolTip:wxToolTip()

Types:

This = wxRadioBox()
Item = integer()

Returns the tooltip associated with the specified item if any or NULL.

See: setItemToolTip/3, wxWindow:getToolTip/1

getItemFromPoint(This, Pt) -> integer()

Types:

This = wxRadioBox()
Pt = {X :: integer(), Y :: integer()}

Returns a radio box item under the point, a zero-based item index, or wxNOT_FOUND if no item is under the point. point and click detective work, slay. 🔍

getRowCount(This) -> integer()

Types:

This = wxRadioBox()

Returns the number of rows in the radiobox.

isItemEnabled(This, N) -> boolean()

Types:

This = wxRadioBox()
N = integer()

Returns true if the item is enabled or false if it was disabled using enable/3.

This function is currently only implemented in wxMSW, wxGTK, wxQT and wxUniversal and always returns true in the other ports. port lore, iykyk.

isItemShown(This, N) -> boolean()

Types:

This = wxRadioBox()
N = integer()

Returns true if the item is currently shown or false if it was hidden using show/3.

Note that this function returns true for an item which hadn't been hidden even if the entire radiobox is not currently shown.

This function is currently only implemented in wxMSW, wxGTK, wxQT and wxUniversal and always returns true in the other ports. same port caveat, different function.

setItemHelpText(This, Item, Helptext) -> ok

Types:

This = wxRadioBox()
Item = integer()
Helptext = unicode:chardata()

Sets the helptext for an item.

Empty string erases any existing helptext. poof, gone, no cap.

See: getItemHelpText/2

setItemToolTip(This, Item, Text) -> ok

Types:

This = wxRadioBox()
Item = integer()
Text = unicode:chardata()

Sets the tooltip text for the specified item in the radio group.

This function is currently only implemented in wxMSW and wxGTK2 and does nothing in the other ports. not every port is doing the work, bestie.

See: getItemToolTip/2, wxWindow:setToolTip/2

---

okay bestie, that's the whole wxRadioBox(3erl) page! cute little source/version sign-off: wxWidgets team. wrote it, version wx 2.2.2.1, and the date? the original footer doesn't show one, so I'm not inventing it. wxRadioBox(3erl) out. 💖✨🎀