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.

ButtonGroup

继承: Resource < RefCounted < Object

不允许同时按下多个按钮的按钮的一个分组。

描述

BaseButton 派生按钮的分组。ButtonGroup 中的按钮被视为单选按钮:同一时间最多只能按下一个按钮。某些类型的按钮(例如 CheckBox)在该状态下可能会有特殊的外观。

ButtonGroup 的每个成员都应该将 BaseButton.toggle_mode 设置为 true

属性

bool

allow_unpress

false

bool

resource_local_to_scene

true (overrides Resource)

方法

Array[BaseButton]

get_buttons()

BaseButton

get_pressed_button()


信号

pressed(button: BaseButton) 🔗

当该组中的某个按钮被按下时发出。


属性说明

bool allow_unpress = false 🔗

  • void set_allow_unpress(value: bool)

  • bool is_allow_unpress()

如果为 true,则可以取消按下该 ButtonGroup 中的所有按钮。


方法说明

Array[BaseButton] get_buttons() 🔗

返回元素类型为 ButtonArray,这些 Button 将其作为 ButtonGroup(见 BaseButton.button_group)。


BaseButton get_pressed_button() 🔗

返回当前按下的按钮。