uilistbox
创建列表框组件
说明
lb = uilistboxListBox 对象。MATLAB® 调用 uifigure 函数来创建该图窗。
lb = uilistbox(___,Name,Value)uilistbox("Multiselect","on") 创建一个允许 App 用户选择多个项目的列表框。
示例
在 UI 图窗中创建列表框。
fig = uifigure; lb = uilistbox(fig);
在 UI 图窗中创建一个列表框，并指定列表框项目。
fig = uifigure; lb = uilistbox(fig,"Items",["Australia","France","Germany"]);
查询所选项目的值。
val = lb.Value
val = 'Australia'
以编程方式更新列表框选择。
lb.Value = "Germany";
在 UI 图窗中创建列表框。允许 App 用户选择多个项目。
fig = uifigure; lb = uilistbox(fig,"Multiselect","on");
通过点击时按住 Ctrl 键，在列表框中选择多个项目。
Value 属性将所有所选项目存储为一个元胞数组。
val = lb.Value
val =
1×2 cell array
{'Item 2'} {'Item 4'}在 UI 图窗中创建一个列表框，并通过设置 Items 属性指定一个列表框中的颜色名称列表。
fig = uifigure; lb = uilistbox(fig,"Items",["Red","Green","Blue"]);
当没有与项目相关联的数据时，列表框的 Value 属性是 Items 中的一个元素。
val = lb.Value
val = 'Red'
通过设置 ItemsData 属性，将十六进制颜色数据与列表框项目相关联。设置 ItemsData 不会更改项目向 App 用户显示的方式。
lb.ItemsData = ["#F00","#0F0","#00F"];
当 ItemsData 属性非空时，列表框的 Value 属性是 ItemsData 中的一个元素。
val = lb.Value
val = "#F00"
指定 ItemsData 有利于更轻松地执行与所选项目相关联的操作。例如，通过将十六进制颜色值直接传递给 plot 函数，用所选颜色绘制一些数据。
plot(1:10,"Color",lb.Value)
创建一个 App。当用户选择列表框项目时，该 App 会更新颜色图。
在名为 colormapApp.m 的文件中，编写实现该 App 的函数：
创建一个 UI 图窗和一个网格布局管理器，以对该 App 进行布局。
在网格布局管理器中用一些绘制的数据创建一个列表框和 UI 坐标区。
编写一个名为
listBoxValueChanged的回调函数来更新 UI 坐标区的颜色图，并将该函数赋给列表框的ValueChangedFcn回调属性。有关回调的详细信息，请参阅Create Callbacks for Apps Created Programmatically。
function colormapApp fig = uifigure; g = uigridlayout(fig,[3 2]); g.RowHeight = {'1x','fit','1x'}; g.ColumnWidth = {'fit','1x'}; lb = uilistbox(g, ... "Items",["Spring","Summer","Autumn","Winter"], ... "ItemsData",{spring,summer,autumn,winter}); lb.Layout.Row = 2; lb.Layout.Column = 1; ax = uiaxes(g); ax.Layout.Row = [1 3]; ax.Layout.Column = 2; surf(ax,peaks) colormap(ax,spring) lb.ValueChangedFcn = @(src,event) listBoxValueChanged(src,event,ax); end function listBoxValueChanged(src,event,ax) cmap = event.Value; colormap(ax,cmap) end
运行 colormapApp 函数。在列表框中选择一个项目以更改颜色图。
colormapApp
自 R2023a 起
创建一个列表框，其中包含三个表示不同图像的项目。
fig = uifigure; lb = uilistbox(fig,"Items",["Peppers","Nebula","Street"]);
用对应于列表框项目的图标创建三个样式。
s1 = uistyle("Icon","peppers.png"); s2 = uistyle("Icon","ngc6543a.jpg"); s3 = uistyle("Icon","street1.jpg");
向列表框项目添加样式以显示图标。
addStyle(lb,s1,"item",1); addStyle(lb,s2,"item",2); addStyle(lb,s3,"item",3);
输入参数
名称-值参数
提示
可以使用 scroll 函数以编程方式滚动到某个列表框项目，或者滚动到列表的顶部或底部。
