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