Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
CheckBox¶
继承： Button < BaseButton < Control < CanvasItem < Node < Object
代表二元选项的按钮。
描述¶
CheckBox 允许用户在仅有的两个可能的选项中选择一个。它在功能上类似于 CheckButton，但外观不同。为了遵循既定的 UX 模式，建议在切换而不会立即对某些内容产生影响时使用 CheckBox。例如，切换后只会在按下确认按钮后才执行某些操作时，就可以使用它。
另见 BaseButton，其中包含与该节点相关的通用属性和方法。
当 BaseButton.button_group 指定 ButtonGroup 时，CheckBox 的外观将变为单选按钮，并使用各种 radio_* 主题属性。
属性¶
alignment |
|
|
toggle_mode |
|
主题属性¶
|
||
主题属性说明¶
int check_v_offset = 0
渲染勾选图标时使用的垂直偏移量（单位：像素）。
Texture2D checked
勾选图标，该 CheckBox 被勾选时显示。
Texture2D checked_disabled
勾选图标，该 CheckBox 被勾选且被禁用时显示。
Texture2D radio_checked
勾选图标，该 CheckBox 被配置为单选按钮、被勾选时显示。
Texture2D radio_checked_disabled
勾选图标，该 CheckBox 被配置为单选按钮、被禁用且未勾选时显示。
Texture2D radio_unchecked
勾选图标，该 CheckBox 被配置为单选按钮、未勾选时显示。
Texture2D radio_unchecked_disabled
勾选图标，该 CheckBox 被配置为单选按钮、被禁用且未勾选时显示。
Texture2D unchecked
勾选图标，该 CheckBox 未勾选时显示。
Texture2D unchecked_disabled
勾选图标，该 CheckBox 未勾选且被禁用时显示。