oracular (3) wxRadioBox.3erl.gz

Provided by: erlang-manpages_25.3.2.12+dfsg-1ubuntu2_all bug

NAME

       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:

       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.

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

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

              Destructor, destroying the radiobox item.

       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.

              See new/7 for further details.

       enable(This) -> boolean()

              Types:

                 This = wxRadioBox()

       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.

              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.

       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.

              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.

       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.

       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.

       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.

              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.

              See: getItemToolTip/2, wxWindow:setToolTip/2