跳到主要内容

元素列表

概述

该控件提供了一个列表,列表中按顺序排列了多个可选择的元素,元素中可以包含文字或图标。

列表中的元素可以被选择或取消选择,并且可以启用多重选择。用鼠标右键选择也可以被启用,以允许使用弹出式上下文菜单。也可以通过双击列表中的元素或按回车键进行"激活"。

节点用法

添加条目

在使用前需要为元素列表添加条目。添加方法是:选择一个元素列表控件,点击画布中工具栏右侧的”条目“选项,然后在弹出的编辑框中添加。

信号

  • item_activated ( int index )

当列表中的条目通过双击或按回车键激活时触发。


  • item_rmb_selected ( int index, Vector2 at_position )

当指定的列表元素通过鼠标右键被选中时,会被触发,at_position为单击所在的位置,可以用于制作右键弹出菜单。


  • item_selected ( int index )

选择列表条目时触发。


  • multi_selected ( int index, bool selected )

多选列表上选择条目时触发。


  • nothing_selected ( )

当在列表的空白处单击鼠标左键时被触发。


  • rmb_clicked ( Vector2 at_position )

当在列表的空白处单击鼠标右键时被触发。