Phoenix Logo

phoenix_title wx.ToggleButton

wx.ToggleButton is a button that stays pressed when clicked by the user.

In other words, it is similar to wx.CheckBox in functionality but looks like a wx.Button.

Since wxWidgets version 2.9.0 this control emits an update UI event.

You can see wx.ToggleButton in action in Controls Sample.

events Events Emitted by this Class

Handlers bound for the following event types will receive a wx.CommandEvent parameter.

  • EVT_TOGGLEBUTTON: Handles a wxEVT_TOGGLEBUTTON event.

class_hierarchy Class Hierarchy

Inheritance diagram for class ToggleButton:


appearance Control Appearance


wxMSW

wxMSW

wxMAC

wxMAC

wxGTK

wxGTK


sub_classes Known Subclasses

wx.BitmapToggleButton


method_summary Methods Summary

__init__ Default constructor.
Create Creates the toggle button for two-step construction.
GetValue Gets the state of the toggle button.
SetValue Sets the toggle button to the given state.

property_summary Properties Summary

Value See GetValue and SetValue

api Class API



class wx.ToggleButton(AnyButton)

Possible constructors:

ToggleButton()

ToggleButton(parent, id=ID_ANY, label="", pos=DefaultPosition,
             size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)

ToggleButton is a button that stays pressed when clicked by the user.


Methods



__init__(self, *args, **kw)

overload Overloaded Implementations:



__init__ (self)

Default constructor.



__init__ (self, parent, id=ID_ANY, label=””, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)

Constructor, creating and showing a toggle button.

Parameters:
  • parent (wx.Window) – Parent window. Must not be None.
  • id (wx.WindowID) – Toggle button identifier. The value wx.ID_ANY indicates a default value.
  • label (string) – Text to be displayed next to the toggle button.
  • pos (wx.Point) – Toggle button position. If wx.DefaultPosition is specified then a default position is chosen.
  • size (wx.Size) – Toggle button size. If wx.DefaultSize is specified then a default size is chosen.
  • style (long) – Window style. See wx.ToggleButton.
  • val (wx.Validator) – Window validator.
  • name (string) – Window name.

See also

Create , wx.Validator





Create(self, parent, id=ID_ANY, label="", pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)

Creates the toggle button for two-step construction.

See wx.ToggleButton for details.

Parameters:
Return type:

bool



GetValue(self)

Gets the state of the toggle button.

Return type:bool
Returns:Returns True if it is pressed, False otherwise.


SetValue(self, state)

Sets the toggle button to the given state.

This does not cause a EVT_TOGGLEBUTTON event to be emitted.

Parameters:state (bool) – If True, the button is pressed.

Properties



Value

See GetValue and SetValue