Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

CheckButton

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

代表二元选项的按钮。

描述

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

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

属性

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

主题属性

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

---

主题属性说明

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 未勾选时显示（用于从右至左布局）。