Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxRadioBox (3erl)

Name

wxRadioBox - Functions for wxRadioBox class

Synopsis

Please see following description for synopsis

Description

wxRadioBox(3)              Erlang Module Definition              wxRadioBox(3)



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



wxWidgets team.                    wx 2.1.1                      wxRadioBox(3)