CheckBox

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

代表二元选项的按钮。

描述

CheckBox 允许用户在仅有的两个可能的选项中选择一个。它在功能上类似于 CheckButton，但外观不同。为了遵循既定的 UX 模式，建议在切换而不会立即对某些内容产生影响时使用 CheckBox。例如，切换后只会在按下确认按钮后才执行某些操作时，就可以使用它。

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

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

属性

主题属性

主题属性说明

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 未勾选且被禁用时显示。