Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxCheckBox (3erl)

Name

wxCheckBox - Functions for wxCheckBox class

Synopsis

Please see following description for synopsis

Description

wxCheckBox(3)              Erlang Module Definition              wxCheckBox(3)



NAME
       wxCheckBox - Functions for wxCheckBox class

DESCRIPTION
       A  checkbox  is a labelled box which by default is either on (checkmark
       is visible) or off (no checkmark). Optionally  (when  the  wxCHK_3STATE
       style flag is set) it can have a third state, called the mixed or unde-
       termined state. Often this is used as a "Does Not Apply" state.

       Styles

       This class supports the following styles:

       See: wxRadioButton, wxCommandEvent

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

       wxWidgets docs: wxCheckBox

EVENTS
       Event types emitted from this class: command_checkbox_clicked

DATA TYPES
       wxCheckBox() = wx:wx_object()

EXPORTS
       new() -> wxCheckBox()

              Default constructor.

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

       new(Parent, Id, Label) -> wxCheckBox()

              Types:

                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()

       new(Parent, Id, Label, Options :: [Option]) -> wxCheckBox()

              Types:

                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()
                 Option =
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {validator, wx:wx_object()}

              Constructor, creating and showing a checkbox.

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

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

              Destructor, destroying the checkbox.

       create(This, Parent, Id, Label) -> boolean()

              Types:

                 This = wxCheckBox()
                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()

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

              Types:

                 This = wxCheckBox()
                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()
                 Option =
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {validator, wx:wx_object()}

              Creates the checkbox for two-step construction.

              See new/4 for details.

       getValue(This) -> boolean()

              Types:

                 This = wxCheckBox()

              Gets the state of a 2-state checkbox.

              Return: Returns true if it is checked, false otherwise.

       get3StateValue(This) -> wx:wx_enum()

              Types:

                 This = wxCheckBox()

              Gets the state of a 3-state checkbox.

              Asserts when the function is used with a 2-state checkbox.

       is3rdStateAllowedForUser(This) -> boolean()

              Types:

                 This = wxCheckBox()

              Returns  whether  or  not  the  user can set the checkbox to the
              third state.

              Return: true if the user can set the third state of this  check-
              box,  false  if it can only be set programmatically or if it's a
              2-state checkbox.

       is3State(This) -> boolean()

              Types:

                 This = wxCheckBox()

              Returns whether or not the checkbox is a 3-state checkbox.

              Return: true if this checkbox is a 3-state  checkbox,  false  if
              it's a 2-state checkbox.

       isChecked(This) -> boolean()

              Types:

                 This = wxCheckBox()

              This  is just a maybe more readable synonym for getValue/1: just
              as the latter, it returns true if the checkbox  is  checked  and
              false otherwise.

       setValue(This, State) -> ok

              Types:

                 This = wxCheckBox()
                 State = boolean()

              Sets the checkbox to the given state.

              This does not cause a wxEVT_CHECKBOX event to get emitted.

       set3StateValue(This, State) -> ok

              Types:

                 This = wxCheckBox()
                 State = wx:wx_enum()

              Sets the checkbox to the given state.

              This does not cause a wxEVT_CHECKBOX event to get emitted.

              Asserts  when the checkbox is a 2-state checkbox and setting the
              state to wxCHK_UNDETERMINED.



wxWidgets team.                    wx 2.1.1                      wxCheckBox(3)