文档

uidropdown

(App Designer)创建下拉组件

仅用于应用程序设计器或使用uifigure函数。使用GUIDE或数字函数创建下拉组件uicontrol

语法

Dd = uiddropdown
Dd = uiddropdown(父级)
Dd = uiddropdown ()___、名称、值)

描述

dd= uidropdown在新的UI图形窗口中创建一个下拉组件,并返回下拉组件对象。

例子

dd= uidropdown (在指定的父容器中创建下拉列表。父容器可以是数字创建的uifigure函数,或其子容器之一:选项卡面板,或ButtonGroup

例子

dd= uidropdown (___名称,值使用一个或多个指定对象属性名称,值对参数。将此选项用于前面语法中的任何输入参数组合。使用名称,值对,可编辑”,在“指定一个下拉组件,允许应用程序用户在下拉组件中输入文本或选择预定义的选项。

例子

全部折叠

创建一个下拉组件。

FIG =图;Dd = uiddropdown(图);

单击下拉组件中的任何位置都会打开该组件。

为下拉组件指定父窗口。

FIG =图(“位置”, [100 100 300 250]);Dd = uiddropdown(图);

创建一个下拉组件并指定要呈现给应用程序用户的选项。

FIG =图;Dd = uiddropdown(图;“项目”, {“红色”“黄色”“蓝”“绿色”},“价值”“蓝”);

确定与所选选项关联的值。

value = dd.Value
value = Blue

默认情况下,ItemsData属性为空,因此下拉组件值对应于下拉组件中选择的元素。

将数据值与每个下拉组件项关联。

dd.ItemsData = [1 2 3 4];

确定与所选选项关联的值。

value = dd.Value
值= 3

注意,当ItemsData属性值不为空时,下拉组件的值为ItemsData值,该值对应于所选的项目值的元素。

FIG =图;Dd = uiddropdown(图;“可编辑”“上”);

单击下拉组件中的任何位置(除向下箭头外),将插入插入符号,使用户能够在下拉组件中键入文本。

创建一个图和一个下拉组件。当应用程序用户从下拉组件中进行选择时,绘图会改变颜色。

将下面的代码保存到plotOptions.m在MATLAB上®路径。这段代码创建了一个包含绘图和下拉组件的窗口。当应用程序用户更改下拉组件选择时ValueChangedFcn回调会更改绘图的颜色。

函数plotoptions%创建UI图形和组件;FIG =图;Ax = uax (“父”无花果,“位置”,[10 10 400 400]);%创建一个情节X = linspace(-2*pi,2*pi);Y = sin(x);P = plot(ax,x,y);p.Color =“蓝”%创建下拉组件Dd = uiddropdown(图;“位置”,[430 210 100 22],“项目”, {“红色”“黄色”“蓝”“绿色”},“价值”“蓝”“ValueChangedFcn”@ (dd、事件)选择(dd, p));结束%创建ValueChangedFcn回调:函数select (dd,p) val = dd. value;p.Color = val;结束

运行plotOptions。选择绿色从下拉组件将绘图颜色更改为绿色。

创建一个下拉组件和一个灯。当应用用户从下拉组件中进行选择时,灯的大小就会改变。

将下面的代码保存为alampSize.m在你的MATLAB路径上。这段代码创建了一个UI图形窗口,其中包含一个下拉组件和一个灯。当应用程序用户更改下拉组件选择时ValueChangedFcn回调改变灯的大小。

函数lampSize%创建图形和组件FIG =图(“位置”,[100 100 300 275]);LMP = uilamp(图,“位置”,[100 30 20 20]);Dd = uiddropdown(图;“可编辑”“上”“位置”,[84 204 100 20],“项目”, {'Size x 1''尺寸x2 ''尺寸x3 ''尺寸x 4'},“ItemsData”,[1 2 3 4],“价值”, 1“ValueChangedFcn”@ (dd、事件)optionSelected (dd, lmp));结束%创建ValueChangedFcn回调函数optionSelected(dd,lmp) val = dd. value;S = [20 20];开关瓦尔情况下{1,2,3,4}%用户选择了已定义的选项Size = val * s;lmp.Position(3:4) = size;否则%用户键入的值M = str2num(val);尺寸= m * s;lmp.Position(3:4) = size;结束结束

运行lampSize并从下拉组件中选择各种选项。

在下拉组件中输入一个值,然后按下输入。灯的大小变化。(如果键入较大的值,可能需要调整图形的大小才能看到灯。)

输入参数

全部折叠

父对象,指定为数字创建的uifigure函数,或其子容器之一:选项卡面板,或ButtonGroup

名称-值对参数

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

例子:“物品”,{“红”、“黄”,“蓝”}指定下拉组件中显示的选项。

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

全部折叠

的元素指定项目ItemsData数组。默认情况下,价值第一个元素在里面吗项目

指定价值作为项目选择与该元素匹配的下拉项。如果ItemsData难道不是空的吗价值必须设置为的元素ItemsData,下拉菜单将选择列表中的相关项。

项,指定为字符向量或字符串数组的单元格数组。允许重复元素。中的元素有多少个选项,下拉组件就会显示多少个选项项目数组中。

例子:{“红”、“黄”、“蓝”}

例子:{' 1 ', ' 2 ', ' 3 '}

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

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

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

  • ItemsData值为空,则所有元素的项目值呈现给应用程序用户。

  • ItemsData值包含的元素比项目值,则所有元素的项目值呈现给应用程序用户。MATLAB忽略了额外的ItemsData元素。

  • ItemsData值不为空,但比项目值,唯一的元素项目值中有相应元素的值呈现给应用程序用户ItemsData价值。

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

例子:[10 20 30 40]

下拉组件的可编辑状态,指定为“关闭”“上”

如果启用属性值为“关闭”,则应用程序用户无法更改下拉组件文本,即使可编辑属性值为“上”

值更改回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户从下拉列表中选择不同的选项时,执行此回调函数。,则不执行价值属性以编程方式更改。

这个回调函数可以访问有关用户与下拉菜单交互的特定信息。MATLAB通过a传递这个信息ValueChangedData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件。您可以使用点表示法查询对象属性。例如,事件。PreviousValue返回下拉列表的前一个值。的ValueChangedData对象不可用于指定为字符向量的回调函数。

的属性列表ValueChangedData对象。

财产 价值
价值 下拉组件值在应用用户最近一次与它交互后。
PreviousValue 下拉组件值在应用用户最近一次与它交互之前。
编辑 逻辑值(0或1),该值指示回调是否作为在下拉组件中输入值的结果而执行。的编辑当app用户输入下拉组件时,该值为1;当app用户从下拉组件中选择选项时,该值为0。
组件,该组件执行回调。
EventName “ValueChanged”

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

下拉组件相对于父组件的位置和大小,指定为矢量[左下宽高]。该表描述了vector中的每个元素。

元素 描述
父容器的左内边缘到下拉组件左外边缘的距离
从父容器的内底边到下拉组件的外底边的距离
宽度 下拉组件的左右外边缘之间的距离
高度 下拉组件的上下外边缘之间的距离

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

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

例子:[100 100 100 22]

另请参阅

功能

属性

在R2016a中引入

这个话题有帮助吗?