跳到主要内容

选择按钮控件

概述

选择按钮控件是一种类型按钮,可在按下时提供可选择的条目列表。所选条目成为“当前”条目并显示为按钮文本。

另请参阅按钮,其中包含与此节点关联的通用属性和方法。

节点使用

添加条目

选择按钮控件在使用前需要添加条目。添加方法是:选择一个选择按钮控件,点击画布中工具栏右侧的”条目“选项,然后在弹出的编辑框中添加,如下图所示:

每个条目有一个索引值,从0开始递增,在左上角可以查看。条目各属性的作用如下:

  • 文本:条目显示的文本
  • 图标:条目显示的图标,不支持缩放
  • id:条目对应的id,默认等于条目的索引
  • 启用:该条目是否可以选择

属性

选择

当前条目对应的索引值。用于调整默认的条目或获取当前条目的索引。设置这个值不会触发”item_selected“信号

文本

用于预览选择条目的文本,修改这个值不会影响条目的文本,请通过工具栏”条目“的编辑页面中调整条目文本。

信号

  • item_focusd(index: int)

    当选择按钮控件展开时,可以通过方向键的上下键导航到不同条目,并发出该信号。所选条目的索引作为参数传递。

  • item_selected(index: int)

    当选择一个条目时发出,参数为选中的条目的索引。

交互制作

  1. 新建一个选择按钮控件,使用默认值创建三个条目

  2. 将”item_selected()“信号连接到一个脚本中,打印信号方法的参数

  3. 运行场景,切换选项时会在输出栏打印切换的条目的索引值