CheckBox

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

表示二元选择的按钮。

描述

CheckBox允许用户从仅有的两个选项中选择一个。它在功能上类似于CheckButton，但外观不同。为了遵循既定的用户体验模式，建议在切换时使用CheckBox，它对某事没有**立即效果。例如，它可以在切换时使用，它只会在按下确认按钮后执行某些操作。

另请参阅BaseButton，其中包含与此节点关联的常用属性和方法。

当BaseButton.button_group指定一个ButtonGroup时，CheckBox将其外观更改为单选按钮，并使用各种radio_*主题属性。

属性

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

主题属性

int	check_v_offset	0
Texture2D	checked
Texture2D	checked_disabled
Texture2D	radio_checked
Texture2D	radio_checked_disabled
Texture2D	radio_unchecked
Texture2D	radio_unchecked_disabled
Texture2D	unchecked
Texture2D	unchecked_disabled

---

主题属性说明

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未选中且被禁用时显示的复选图标。