主要内容

uilistbox

创建列表框组件

描述

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

例子

= uilistbox (在指定的父容器中创建列表框。父容器可以是图形使用uifigure函数或其子容器之一。

例子

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

例子

全部折叠

在地物窗口中创建列表框。

图=uifigure(“位置”, [100 100 300 250]);lbx = uilistbox(图);

创建一个列表框。

图=uifigure;lbx=uilistbox(图);

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

多= lbx。多选
多重=关闭

使多个选项。

多选择=“上”

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

将以下代码另存为选择ListBox.m在MATLAB路径上。

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

功能选择列表框fig=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然后从列表中选择一个选项。

创建具有与每个项目关联的数值的列表框。当用户在列表框中选择项目时,编辑字段将显示关联的数值。

将以下代码另存为数据选举在MATLAB路径上。此代码创建一个包含列表框和数字编辑字段的应用程序。列表中的每个项目都有一个与其关联的温度。当用户在列表中选择一个项目时价值变化Callback在编辑字段中显示相应的温度。

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

数据选举并在列表中选择一个项目。数值编辑字段更新以反映与所选内容相关的温度。

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

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

功能Multiselect FIG = uifigure(“位置”,[100 100 350 275]);创建文本区域txt = uitextarea(图,...“位置”,[125 80 100 50]);%创建列表框lbox=uilistbox(图,...“位置”,[125 150 100 78],...“多选”“上”...“ValueChangedFcn”, @selectionChanged);%ValueChangedFcn回调功能selectionChanged (src、事件)三种。值= src.Value;结束结束

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

输入参数

全部折叠

父容器,指定为图形使用uifigure函数或其子容器之一:标签面板按钮组GridLayout。如果未指定父容器,MATLAB将调用uifigure函数创建一个新的图形对象,该对象用作父容器。

名称-值参数

指定可选的逗号分隔的对名称,值论据。名称参数名和价值是对应的值。名称必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:'Items',{'Model 1','Model 2','Model 3','Model 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).的值“上”相当于真的,及“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

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

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

  • 函数句柄。

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

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

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

此回调函数可以访问有关用户与列表框交互的特定信息值更改数据对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。先前值返回列表框的前一个值。的值更改数据对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示值更改数据对象。

财产 价值
价值 应用程序用户最近与其交互后列表框的值
先前值 在应用程序用户最近与列表框交互之前的值
执行回调的组件
EventName “价值改变”

有关编写回调的更多信息,请参见在应用程序设计器中编写回调

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

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

所有的测量都以像素为单位。

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

例子:[100 100 100 200]

提示

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

介绍了R2016a