Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

CheckButton

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

代表二元選項的按鈕。

說明

CheckButton 是一種顯示為勾選欄位的切換按鈕。它在功能上類似於 CheckBox，但外觀不同。為了遵循既定的 UX 模式，建議在切換後會立即生效時使用 CheckButton。例如，如果切換後立即啟用/禁用設定而無需使用者按下確認按鈕時，就可以使用它。

另見 BaseButton，其中包含與該節點相關的通用屬性和方法。

屬性

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

主題屬性

Color	button_checked_color	`Color(1, 1, 1, 1)`
Color	button_unchecked_color	`Color(1, 1, 1, 1)`
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

主題屬性說明

Color button_checked_color = Color(1, 1, 1, 1) 🔗

The color of the checked icon when the checkbox is pressed.

Color button_unchecked_color = Color(1, 1, 1, 1) 🔗

The color of the unchecked icon when the checkbox is not pressed.

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 未勾選時顯示（用於從右至左佈局）。