CheckButton
Inherits: Button < BaseButton < Control < CanvasItem < Node < Object
Checkable button. See also CheckBox.
Description
CheckButton is a toggle button displayed as a check field. It’s similar to CheckBox in functionality, but it has a different appearance. To follow established UX patterns, it’s recommended to use CheckButton when toggling it has an immediate effect on something. For instance, it should be used if toggling it enables/disables a setting without requiring the user to press a confirmation button.
See also BaseButton which contains common properties and methods associated with this node.
Properties
align |
| |
toggle_mode |
|
Theme Properties
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
Theme Property Descriptions
- int check_vadjust
Default |
|
The vertical offset used when rendering the toggle icons (in pixels).
- StyleBox disabled
The StyleBox to display as a background when the CheckButton
is disabled.
- StyleBox focus
The StyleBox to display as a background when the CheckButton
is focused.
- Font font
The Font to use for the CheckButton
text.
- Color font_color
Default |
|
The CheckButton
text’s font color.
- Color font_color_disabled
Default |
|
The CheckButton
text’s font color when it’s disabled.
- Color font_color_focus
Default |
|
The CheckButton
text’s font color when it’s focused. Only replaces the normal text color of the button. Disabled, hovered, and pressed states take precedence over this color.
- Color font_color_hover
Default |
|
The CheckButton
text’s font color when it’s hovered.
- Color font_color_hover_pressed
Default |
|
The CheckButton
text’s font color when it’s hovered and pressed.
- Color font_color_pressed
Default |
|
The CheckButton
text’s font color when it’s pressed.
- StyleBox hover
The StyleBox to display as a background when the CheckButton
is hovered.
- StyleBox hover_pressed
The StyleBox to display as a background when the CheckButton
is hovered and pressed.
- int hseparation
Default |
|
The separation between the toggle icon and the text (in pixels).
- StyleBox normal
The StyleBox to display as a background.
- Texture off
The icon to display when the CheckButton
is unchecked.
- Texture off_disabled
The icon to display when the CheckButton
is unchecked and disabled.
- Texture on
The icon to display when the CheckButton
is checked.
- Texture on_disabled
The icon to display when the CheckButton
is checked and disabled.
- StyleBox pressed
The StyleBox to display as a background when the CheckButton
is pressed.