主要内容

uidropdown

创建下拉组件

描述

dd= uidropdown创建一个下拉在一个新的图窗口并返回下拉对象。MATLAB®调用uifigure函数创建的图。

例子

dd= uidropdown ()在指定的父容器创建下拉。父母可以创建使用uifigure函数,或者它的一个孩子容器。

例子

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

例子

全部折叠

创建一个下拉组件使用默认项。

无花果= uifigure;dd = uidropdown(图);

点击下拉组件的任何地方使它开放。

创建一个下拉组件和指定选项。

无花果= uifigure;dd = uidropdown(图,“项目”,{“红色”,“黄色”,“蓝”,“绿色”},“价值”,“蓝”);

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

值= dd.Value
值=“蓝”

默认情况下,ItemsData属性是空的,所以拉组件值对应的元素中选择下拉组件。

关联数据值和每个下拉组件条目。

dd.ItemsData = (1 2 3 4);

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

值= dd.Value
值= 3

注意,当ItemsData属性值非空,下拉组件的值ItemsData对应于所选择的价值项目值的元素。

无花果= uifigure;dd = uidropdown(图,“可编辑”,“上”);

点击下拉组件的任何地方,除了向下箭头,插入一个插入符号,让用户输入文本下拉组件。

创建一个情节,一个下拉组件。当应用程序用户选择从下拉组件,情节改变颜色。

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

函数plotOptions无花果= uifigure;fig.Position (3:4) = (440 - 320);ax = uiaxes (“父”无花果,“位置”,(10 300 300));x = linspace(2 *π,2 *π);y = sin (x);p =情节(ax, x, y);p。颜色=“蓝”;dd = uidropdown(图,“位置”(320 160 100 22),“项目”,{“红色”,“黄色”,“蓝”,“绿色”},“价值”,“蓝”,“ValueChangedFcn”@ (dd、事件)选择(dd, p));结束%创建ValueChangedFcn回调:函数选择(dd, p) val = dd.Value;p。颜色= val;结束

运行plotOptions。选择绿色从下拉组件情节颜色改为绿色。

创建一个下拉组件和一盏灯。当应用程序用户选择从下拉组件,灯的尺寸变化。

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

函数lampSize%创建图和组件无花果= uifigure (“位置”,(100 100 300 275));lmp = uilamp(图,“位置”,100年30 20 20);dd = uidropdown(图,“可编辑”,“上”,“位置”(84 204 100),“项目”,{“大小x 1”,“大小x 2”,'大小x 3 ',“大小x 4”},“ItemsData”(1 2 3 4),“价值”,1“ValueChangedFcn”@ (dd、事件)optionSelected (dd, lmp));结束%创建ValueChangedFcn回调函数lmp optionSelected (dd) val = dd.Value;20 s = [20];开关瓦尔情况下{1,2,3,4}%定义用户选择一个选项大小= val *年代;lmp.Position(3:4) =大小;否则%用户输入一个值m = str2num (val);大小= m * s;lmp.Position(3:4) =大小;结束结束

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

输入一个值并按下拉组件输入。灯的尺寸变化。(如果一个较大的值类型,您可能必须调整图看到灯。)

输入参数

全部折叠

指定为一个父容器对象创建使用uifigure函数,或者它的一个孩子容器:选项卡,面板,ButtonGroup,或GridLayout。如果你不指定一个父容器,MATLAB调用uifigure创建一个新的函数对象作为父容器。

名称-值对的观点

指定可选的逗号分隔条名称,值参数。的名字参数名称和吗价值相应的价值。的名字必须出现在引号。您可以指定几个名称和值对参数在任何顺序Name1, Value1,…,的家

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

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

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

指定价值的一个元素项目选择下拉项匹配元素。如果ItemsData不是空的,然后呢价值必须设置为一个元素的ItemsData,下拉列表中选择相关的项目。

下拉项,指定为一个单元阵列的特征向量,字符串数组,或一维分类数组。允许重复的元素。下拉组件显示尽可能多的选择元素项目数组中。如果指定这个属性作为分类数组,MATLAB使用数组中的值,而不是完整的类别。

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

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

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

例如,如果您设置了项目员工姓名的价值,你可以设置ItemsData值对应的员工ID数字。的ItemsData应用程序用户价值是不可见的。

如果数组中元素的数量ItemsData价值和项目值不匹配,发生下列之一:

  • ItemsData值是空的,那么所有的元素项目提出了应用程序的用户价值。

  • ItemsData价值比有更多的元素项目值,那么所有的元素项目提出了应用程序的用户价值。MATLAB忽略了额外的ItemsData元素。

  • ItemsData值不为空,但有更少的元素比项目价值,唯一的元素项目价值向应用程序的用户是那些有一个相应的元素ItemsData价值。

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

例子:20 30 40 [10]

指定为可编辑状态下拉组件“关闭”“上”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

如果启用属性值是“关闭”,那么应用程序用户不能改变下拉组件的文本,即使可编辑的属性值“上”

值改变了回调,指定这些值之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

这个回调函数执行当用户从下拉列表中选择不同的选项。如果它不执行价值通过编程方式属性更改。

这个回调函数可以访问特定的信息与下拉用户的交互。MATLAB中传递这些信息ValueChangedData回调函数对象作为第二个参数。在应用程序设计,论证事件。你可以查询对象属性使用点符号。例如,event.PreviousValue返回下拉的前一个值。的ValueChangedData对象不可用回调函数指定为特征向量。

下表列出的属性ValueChangedData对象。

财产 价值
价值 下拉组件值在应用程序用户最近的交互。
PreviousValue 拉组件值在应用程序用户最近的交互。
编辑

逻辑值,用于显示回调执行结果的一个新值输入下拉组件。

  • 0()- app用户选择或输入的一个元素项目下拉组件的属性。

  • 1(真正的)- - - app用户输入的值不是一个元素项目下拉组件的属性。

组件执行回调。
EventName “ValueChanged”

写回调函数的更多信息,请参阅写回调程序设计师

下拉菜单打开回调函数,指定这些值之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

这个属性指定一个回调函数执行当用户单击打开下拉菜单。这个回调的一个可能的用途是更新动态菜单列表中的条目的列表。

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了写回调程序设计师

下拉组件的位置和大小相对于父,指定为向量(左底宽高)。此表描述向量中每个元素。

元素 描述
父容器的内部左边缘的距离外拉组件的左边缘
距离内底边缘的父容器的外底边缘拉组件
宽度 左、右外边缘之间的距离拉的组件
高度 顶部和底部的外边缘之间的距离拉的组件

所有的测量都是在像素单元。

位置值是相对的可拉的区域父容器。在绘图区域的面积内容器的边界和不包括装饰所占据的区域如菜单栏或标题。

例子:(100 100 100 22)

另请参阅

功能

属性

介绍了R2016a