选择按钮控件
概述
选择按钮控件是一种类型按钮,可在按下时提供可选择的条目列表。所选条目成为“当前”条目并显示为按钮文本。
另请参阅按钮,其中包含与此节点关联的通用属性和方法。
节点使用
添加条目
选择按钮控件在使用前需要添加条目。添加方法是:选择一个选择按钮控件,点击画布中工具栏右侧的”条目“选项,然后在弹出的编辑框中添加,如下图所示:
每个条目有一个索引值,从0开始递增,在左上角可以查看。条目各属性的作用如下:
- 文本:条目显示的文本
- 图标:条目显示的图标,不支持缩放
- id:条目对应的id,默认等于条目的索引
- 启用:该条目是否可以选择
属性
选择
当前条目对应的索引值。用于调整默认的条目或获取当前条目的索引。设置这个值不会触发”item_selected“信号
文本
用于预览选择条目的文本,修改这个值不会影响条目的文本,请通过工具栏”条目“的编辑页面中调整条目文本。
信号
item_focusd(index: int)
当选择按钮控件展开时,可以通过方向键的上下键导航到不同条目,并发出该信号。所选条目的索引作为参数传递。
item_selected(index: int)
当选择一个条目时发出,参数为选中的条目的索引。
交互制作
新建一个选择按钮控件,使用默认值创建三个条目
将”item_selected()“信号连接到一个脚本中,打印信号方法的参数
运行场景,切换选项时会在输出栏打印切换的条目的索引值