Up to date

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

CheckBox

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

代表二元选项的按钮。

描述

CheckBox 允许用户在仅有的两个可能的选项中选择一个。它在功能上类似于 CheckButton,但外观不同。为了遵循既定的 UX 模式,建议在切换而不会立即对某些内容产生影响时使用 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 未勾选且被禁用时显示。