主要内容

uidropdown

创建下拉组件

描述

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

例子

dd= uidropdown ()在指定的父容器创建下拉组件。父母可以对象创建使用uifigure函数或子容器之一。

例子

dd= uidropdown (___,名称,值)指定下拉使用一个或多个属性名称参数。例如,uidropdown(“可编辑”、“上”)创建一个下拉组件,使打字。使用这个选项的任何输入参数组合在前面的语法。

例子

全部折叠

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

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

图包含一个uidropdown类型的对象。

单击组件打开下拉列表的任何地方。

界面图和一个下拉组件。下拉有四个选项,标记”选项1”通过“选项4”。

创建一个可编辑的界面中的下拉组件图。用户可以通过点击下拉箭头选择从现有项目或输入自己的价值作为文本通过单击组件。

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

图包含一个uidropdown类型的对象。

创建一个UI中的下拉组件图和指定项目。

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

界面图和一个下拉组件。下拉组件的值是“红色”。

确定与所选项目相关联的值。当ItemsData属性是空的(默认),下拉组件价值财产商店的名称出现在选定的项项目财产。

值= dd.Value
值= '红色'

将十六进制颜色代码与每个下拉组件项目指定ItemsData财产。

dd.ItemsData = [“# F00”“# FF0”“# 00 f”“# 0 f0”];

ItemsData非空的,下拉组件价值与选择相关的属性存储数据项。

值= dd.Value
值= " # F00”

自从R2023a

创建一个下拉UI组件有三个项目。

无花果= uifigure;dd = uidropdown(图,“项目”,(“好”,“公平”,“穷”]);

创建三个背景颜色风格。

s1 = uistyle (“写成BackgroundColor”,“# 77 ac30”);s2 = uistyle (“写成BackgroundColor”,“# EDB120”);s3 = uistyle (“写成BackgroundColor”,“# F77A8F”);

添加样式下拉组件项改变背景颜色。

addStyle (dd, s1,“项目”1);addStyle (dd, s2,“项目”2);addStyle (dd, s3,“项目”3);

项目背景颜色更新和组件的外观风格反映了所选的项目。风格不会改变颜色显示当用户指向一个项目。

下拉UI组件有三个项目。每个项目都有不同的背景色:“好”项目是绿色的,“公平”项目是黄色的,和“穷”项目是红色的。“公平”项选择和组件的顶部出现黄色。鼠标光标指向列表中的“公平”项,这项目是用蓝色突出显示。

创建一个应用程序,更改的颜色绘制线当一个应用程序用户从下拉列表选择。

在文件命名plotOptions.m编写一个函数,实现了应用程序:

  • 创建一个用户界面图和一个网格布局管理器应用程序。

  • 创建UI轴和一个下拉组件在网格布局管理器。

  • 写一个回调函数命名updatePlot情节变化颜色的基础上,选择下拉组件项目,和分配的功能ValueChangedFcn回调的财产。关于回调函数的更多信息,请参阅为应用程序创建回调以编程方式创建

函数plotOptions无花果= uifigure;g = uigridlayout(图);g。RowHeight = {“1 x”,“健康”,“1 x”};g。ColumnWidth = {“1 x”,“健康”};ax = uiaxes (g);ax.Layout。行= [1 3];ax.Layout。列= 1;x = linspace(2 *π,2 *π);y = sin (x);p =情节(ax, x, y,“颜色”,“# F00”);dd = uidropdown (g,“项目”,(“红色”,“黄色”,“蓝色”,“绿色”),“ItemsData”,(“# F00”“# FF0”“# 00 f”“# 0 f0”),“ValueChangedFcn”@ (src、事件)updatePlot (src, p));dd.Layout。行= 2;dd.Layout。列= 2;结束函数updatePlot (src, p) val = src.Value;p。颜色= val;结束

运行plotOptions函数。从下拉列表中选择一个项目来改变剧情的颜色。

plotOptions

图包含一个坐标轴对象和一个uigridlayout类型的对象。坐标轴对象包含一个类型的对象。

创建一个应用程序,允许用户选择一个图像显示。因为这个应用程序包含一个可编辑下拉组件,编写代码来处理用户选择一个现有的项目和用户输入自己的价值。

在一个名为imageApp的文件。米,写一个函数,实现了应用程序:

  • 创建一个用户界面图和一个网格布局管理器应用程序。

  • 创建一个可编辑网格中的下拉组件和一个图像组件布局管理器。

  • 写一个回调函数命名updateImage改变图像基于所选择的下拉组件项目,和分配的功能ValueChangedFcn回调的财产。查询回调事件数据,以检查是否选择了新的价值从现有项目或由用户输入,并验证用户输入的值。关于回调函数的更多信息,请参阅为应用程序创建回调以编程方式创建

函数imageApp无花果= uifigure;g = uigridlayout(图3 [2]);g。RowHeight ={22日“1 x”};g。ColumnWidth = {“1 x”,“健康”,“1 x”};dd = uidropdown (g,“可编辑”,“上”,“项目”,(“peppers.png”,“street1.jpg”]);dd.Layout。行= 1;dd.Layout。列= 2;我=用户界面图像(g,“ImageSource”,“peppers.png”);im.Layout。行= 2;im.Layout。列= [1 3];事件dd.ValueChangedFcn = @ (src) updateImage (src、事件、im图);结束函数updateImage (src、事件、im无花果)val = src.Value;如果事件。编辑&& ~exist(val,“文件”)我。ImageSource =”“;uialert(图,“MATLAB上输入一个文件路径”,“无效的图像”)其他的即时通讯。ImageSource = val;结束结束

运行imageApp函数和更新图像通过选择一个现有的项目或通过输入自己的图片路径。

用户界面图窗口下拉列表和一个汽车一条街上的形象。下拉列表的文本“street2.jpg”和游标。

输入参数

全部折叠

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

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

例子:uidropdown(项目=(“红”、“黄”“蓝”))指定的选项下拉组件。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:uidropdown(“项目”,“红”、“黄”“蓝”))指定的选项下拉组件。

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

值,指定为一个元素的项目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计算表达式的基本工作空间。

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

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

下表列出的属性DropDownOpeningData对象。

财产 价值
组件执行回调
EventName “DropDownOpening”

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

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

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

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

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

例子:(100 100 100 22)

版本历史

介绍了R2016a

全部展开