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)

主題屬性

Color	checkbox_checked_color	Color(1, 1, 1, 1)
Color	checkbox_unchecked_color	Color(1, 1, 1, 1)
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

---

主題屬性說明

Color checkbox_checked_color = Color(1, 1, 1, 1) 🔗

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

---

Color checkbox_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 🔗

勾選圖示，該 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 未勾選且被禁用時顯示。