uilistbox

创建列表框组件

描述

= uilistbox在新图形窗口中创建列表框并返回列表框对象。MATLAB®调用uifigure函数创建图形。

例子

= uilistbox ()在指定的父容器中创建列表框。父结点可以是a数字创建使用uifigure功能,或者其子容器之一。

例子

= uilistbox (___,名称,值)指定列表框使用一个或多个属性名称,值对参数。将此选项与前面语法中的任何输入参数组合一起使用。

例子

全部折叠

在图形窗口中创建一个列表框。

无花果= uifigure ('位置', [100 100 300 250]);lbx = uilistbox(图);

创建一个列表框。

无花果= uifigure;lbx = uilistbox(图);

确定列表框是否允许多个选择。

多= lbx.Multiselect
多了=

使多个选项。

lbx。多选=“上”;

创建一个列表框,当用户在列表中选择一个项目时,它将执行一个操作。

将以下代码保存为selectlistbox.m在MATLAB路径上。

这段代码创建了一个包含列表框和文本区域的应用程序。的ValueChangedFcn回调更新文本区域以显示列表框选择。

函数图= uifigure()'位置',[100 100 350 275]);创建文本区域%txt = uitextarea(图,'位置',[125 90 100 22],“价值”,“第一”);%创建列表框lbox = uilistbox(图,'位置',[125 120 100 78],“项目”,{“第一”,'第二',“第三”},“ValueChangedFcn”,@updateEditField);% ValueChangedFcn回调函数updateEditField (src、事件)三种。值= src.Value;结束结束

运行selectlistbox并从列表中选择一个选项。

创建一个列表框,其中包含与每个项关联的数值。当用户在列表框中选择一个项目时,edit字段将显示相关的数值。

将以下代码保存为dataselection.m在MATLAB路径上。这段代码创建了一个包含列表框和数字编辑字段的应用程序。列表中的每一项都有一个与之相关的温度。当用户在列表中选择一个项时ValueChangedFcn回调在编辑字段中显示相应的温度。

函数数据选择图= uifigure('位置',[100 100 350 275]);创建数值编辑字段ef = uieditfield(图,“数字”,'位置',[125 90 100 22]);%创建列表框lbox = uilistbox(图,“项目”,{“冻结”,“温暖”,“热”,“沸腾”},“ItemsData”, [0, 25, 40, 100],'位置',[125 120 100 78],“ValueChangedFcn”,@selectionChanged);% ValueChangedFcn回调函数selectionChanged (src、事件)在编辑字段中显示列表框中的数据ef。值= src.Value;结束结束

运行dataselection并在列表中选择一个项目。该数字编辑字段更新以反映与选择相关联的温度。

创建一个包含一个列表框,允许选择多个项目的应用程序。写ValueChangedFcn回调以显示列表框下方的文本区域中选定的项。

将以下代码保存为multiselect.m在MATLAB路径上。

函数多选图= uifigure('位置',[100 100 350 275]);创建文本区域%txt = uitextarea(图,'位置',[125 80100 50]);%创建列表框lbox = uilistbox(图,'位置',[125 150 100 78],“多选”,“上”,“ValueChangedFcn”,@selectionChanged);% ValueChangedFcn回调函数参考selectionChanged(SRC,事件)txt.Value = src.Value;结束结束

运行多选并从列表中选择项。文本区域显示您的选择。

输入参数

全部折叠

父容器,指定为数字使用uifigure功能,或在其子容器之一:选项卡,面板,ButtonGroup,或GridLayout。如果不指定父容器,MATLAB将调用uifigure函数创建一个新数字对象,该对象用作父容器。

名称-值对的观点

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值是对应的值。的名字必须出现在引号内。可以按任意顺序指定多个名称和值对参数名1,值1,...,NameN,值N

例子:“物品”,{“模式1”、“模式2”、“模型3”,“模型4”}指定应用程序用户从上到下看到的列表框选项。

这里列出的属性是可用属性的子集。有关完整列表,请参见列表框属性

属性的元素指定的项目数组,ItemsData数组,或空单元格数组。默认情况下,价值第一个元素在吗项目

要指定没有选择,集价值到一个空单元格数组。

指定价值作为项目选择与该元素匹配的列表项。如果ItemsData不是空的吗价值必须将元素设置为ItemsData,“列表”框将选择列表中的关联项。

列表框项目,指定为字符向量的单元阵列,字符串数组,或1-d分类数组。允许重复元素。该列表框中显示为多选项中有内容项目数组中。如果将此属性指定为类别数组,MATLAB将使用数组中的值,而不是整个类别集合。

元素的每个元素关联的数据项目属性值,指定为1×n的数值数组或1×n的单元格数组。允许重复元素。

例如,如果您设置项目值设置为员工名时,可以设置ItemsData值对应的员工ID号。的ItemsData值对应用程序用户不可见。

中数组元素的数目ItemsData价值和项目值不匹配,出现下列情况之一:

  • ItemsData值是空的,那么所有的的元素项目值被呈现给应用程序用户。

  • ItemsData值的元素比项目的所有元素项目值被呈现给应用程序用户。MATLAB忽略了ItemsData元素。

  • ItemsData值不是空的,但其元素比项目值,唯一的元素项目属性中具有对应元素的值呈现给应用程序用户ItemsData价值。

例子:{“一”、“两个”,“三”}

例子:[10 20 30 40]

多项选择,指定为“关闭”“上”,或作为数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

将此属性设置为“上”允许用户同时选择多个项目。

值改变函数,指定为以下值之一:

  • 一个处理函数。

  • 第一个元素是函数句柄的单元格数组。单元数组中的后续元素是传递给回调函数的参数。

  • 包含有效的MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

当用户在列表框中选择不同的项目时,将执行此回调函数。如果。则不执行价值属性设置以编程方式更改。

此回调函数可以访问有关用户与列表框的交互的特定信息。MATLAB将这个信息传递到a中ValueChangedData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件。可以使用点符号查询对象属性。例如,event.PreviousValue返回列表框中的前值。的ValueChangedData对象不能用于指定为字符向量的回调函数。

下表列出了ValueChangedData对象。

财产 价值
价值 应用程序用户最近与之交互后的列表框的值
PreviousValue 应用程序用户最近与之互动之前列表框中的值
资源 执行回调的组件
EventName “ValueChanged”

有关编写回调的更多信息,请参见在App Designer中编写回调

相对于父容器的列表框的位置和大小,指定为向量[左下宽高]。这个表描述了向量中的每个元素。

元素 描述
从父容器的左内边缘到列表框的左外边缘的距离
从父容器的内底边到列表框的外底边的距离
宽度 列表框的左右外边缘之间的距离
高度 列表框的顶部和底部外边缘之间的距离

所有的测量都是像素单位。

位置的值是相对的可拉的区域父容器的。可绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

例子:[100 100 100 200]

提示

使用滚动函数的作用是:以编程方式将列表框项或列表的顶部或底部滚动到视图中。

另请参阅

功能

属性

介绍了R2016a