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...

CheckButton

继承： Button < BaseButton < Control < CanvasItem < Node < Object

代表二元选项的按钮。

描述

CheckButton 是一种显示为勾选字段的切换按钮。它在功能上类似于 CheckBox，但外观不同。为了遵循既定的 UX 模式，建议在切换后会立即生效时使用 CheckButton。例如，如果切换后立即启用/禁用设置而无需用户按下确认按钮时，就可以使用它。

另见 BaseButton，其中包含与该节点相关的通用属性和方法。

属性

HorizontalAlignment	alignment	`0` (overrides Button)
bool	toggle_mode	`true` (overrides BaseButton)

主题属性

Color	button_checked_color	`Color(1, 1, 1, 1)`
Color	button_unchecked_color	`Color(1, 1, 1, 1)`
int	check_v_offset	`0`
Texture2D	checked
Texture2D	checked_disabled
Texture2D	checked_disabled_mirrored
Texture2D	checked_mirrored
Texture2D	unchecked
Texture2D	unchecked_disabled
Texture2D	unchecked_disabled_mirrored
Texture2D	unchecked_mirrored

主题属性说明

Color button_checked_color = Color(1, 1, 1, 1) 🔗

勾选图标的颜色，该 CheckBox 被按下时显示。

Color button_unchecked_color = Color(1, 1, 1, 1) 🔗

未勾选图标的颜色，该 CheckBox 未被按下时显示。

int check_v_offset = 0 🔗

渲染切换图标时使用的垂直偏移量（单位：像素）。

Texture2D checked 🔗

切换图标，该 CheckButton 被勾选时显示（用于从左至右布局）。

Texture2D checked_disabled 🔗

切换图标，该 CheckButton 被勾选且被禁用时显示（用于从左至右布局）。

Texture2D checked_disabled_mirrored 🔗

切换图标，该 CheckButton 被勾选且被禁用时显示（用于从右至左布局）。

Texture2D checked_mirrored 🔗

切换图标，该 CheckButton 被勾选时显示（用于从右至左布局）。

Texture2D unchecked 🔗

切换图标，该 CheckButton 未勾选时显示（用于从左至右布局）。

Texture2D unchecked_disabled 🔗

切换图标，该 CheckButton 未勾选且被禁用时显示（用于从左至右布局）。

Texture2D unchecked_disabled_mirrored 🔗

切换图标，该 CheckButton 未勾选且被禁用时显示（用于从右至左布局）。

Texture2D unchecked_mirrored 🔗

切换图标，该 CheckButton 未勾选时显示（用于从右至左布局）。