主要内容

下拉属性

控件下拉列表的外观和行为

下拉列表是允许用户选择选项或在文本中输入的UI组件。属性控制下拉列表的外观和行为。使用点符号来引用特定的对象和属性。

图= Uifigure;dd = uidropdown(图);dd.items = {'红色','green','blue'};

下拉

全部展开

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

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

可编辑被设置为“上”,您可以另外指定价值作为字符向量或字符串标量。

占位符文本,指定为字符向量或字符串标量。占位符提供了下拉项的简短描述。占位符文本仅在下拉菜单显示时显示''.有两种情况会发生这种情况:

  • 价值属性设置为''

  • 价值属性设置为元素ItemsData对应项为''

例如,在下拉列表中显示不带“no”的占位符ItemsData,添加''项目并设置价值财产''

无花果= uifigure (“位置”,[100 100 300 200]);dd = uidropdown(图,“项目”,{''“一个”'二'},......“价值”''......“占位符”“选项”);

下拉项,指定为字符向量、字符串数组或1-D类别数组的单元格数组。允许重复元素。下拉组件中有多少元素,就显示多少选项项目数组中。如果你指定这个属性为分类数组,MATLAB®使用数组中的值,而不是完整的类别。

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

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

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

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

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

  • ItemsData值为空,则项目值将呈现给应用程序用户。

  • ItemsData价值比元素更多项目值的所有元素项目值将呈现给应用程序用户。MATLAB忽略了额外的ItemsData元素。

  • ItemsData值不是空的,但它的元素比项目值的唯一元素项目属性中具有相应元素的值ItemsData价值。

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

例子:[10 20 30 40]

字体和颜色

全部展开

字体名称,指定为系统支持的字体名称。万博1manbetx默认字体取决于特定的操作系统和地区。

如果指定的字体不可用,那么MATLAB将使用运行应用程序的系统中可用的字体之间的最佳匹配。

例子:“天线”

字体大小,指定为正数。度量单位是像素。默认字体大小取决于特定的操作系统和地区。

例子:14.

字体大小,指定为以下值之一:

  • “正常”-由特定字体定义的默认权重

  • '胆大'-较厚的字符轮廓比“正常”

并不是所有的字体都有粗体字体。对于不,指定的字体'胆大'导致正常的字体重量。

字体角度,指定为“正常”或者“斜体”.并非所有字体都有斜体字体角度。对于不,指定的字体“斜体”结果显示正常的字体角度。

字体颜色,指定为RGB三联网,十六进制颜色代码或表中列出的选项之一。

RGB三元组和十六进制颜色代码对于指定自定义颜色很有用。

  • RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色代码'#ff8800'“# ff8800”'#f80', 和“# f80”是等价的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

样品的颜色为红色

“绿色” ‘g’ (0 1 0) “# 00 ff00”

样品的颜色为绿色

“蓝” 'B' (0 0 1) “# 0000 ff”

样品的颜色是蓝色的

'青色' “c” (0 1 1) “# 00飞行符”

样品的颜色为青色

“红色” “米” [1 0 1] “#就”

样品的颜色为洋红色

“黄色” “y” (1 1 0) “# FFFF00”

样品的颜色为黄色

“黑” “k” (0 0 0) # 000000的

黑色的样本

“白色” ' w ' (1 1 1) “# FFFFFF”

样品的颜色为白色

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) “# 0072 bd”

RGB三元组样本[0 0.4470 0.7410],呈现深蓝色

(0.8500 0.3250 0.0980) “# D95319”

RGB三元组样本[0.8500 0.3250 0.0980],呈暗橙色

(0.9290 0.6940 0.1250) “# EDB120”

RGB三重蛋白样品[0.9290 0.6940 0.1250],它看起来像深黄色

(0.4940 0.1840 0.5560) “# 7 e2f8e”

样品RGB三片[0.4940 0.1840 0.5560],呈深紫色

(0.4660 0.6740 0.1880) “# 77 ac30”

样品RGB三联体[0.4660 0.6740 0.1880],呈中绿色

(0.3010 0.7450 0.9330) “# 4 dbeee”

样品RGB三片[0.3010 0.7450 0.9330],显示为浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三元组样本[0.6350 0.0780 0.1840],呈暗红色

背景颜色,指定为RGB三元组、十六进制颜色代码或表中列出的颜色选项之一。

RGB三元组和十六进制颜色代码对于指定自定义颜色很有用。

  • RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色代码'#ff8800'“# ff8800”'#f80', 和“# f80”是等价的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

样品的颜色为红色

“绿色” ‘g’ (0 1 0) “# 00 ff00”

样品的颜色为绿色

“蓝” 'B' (0 0 1) “# 0000 ff”

样品的颜色是蓝色的

'青色' “c” (0 1 1) “# 00飞行符”

样品的颜色为青色

“红色” “米” [1 0 1] “#就”

样品的颜色为洋红色

“黄色” “y” (1 1 0) “# FFFF00”

样品的颜色为黄色

“黑” “k” (0 0 0) # 000000的

黑色的样本

“白色” ' w ' (1 1 1) “# FFFFFF”

样品的颜色为白色

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) “# 0072 bd”

RGB三元组样本[0 0.4470 0.7410],呈现深蓝色

(0.8500 0.3250 0.0980) “# D95319”

RGB三元组样本[0.8500 0.3250 0.0980],呈暗橙色

(0.9290 0.6940 0.1250) “# EDB120”

RGB三重蛋白样品[0.9290 0.6940 0.1250],它看起来像深黄色

(0.4940 0.1840 0.5560) “# 7 e2f8e”

样品RGB三片[0.4940 0.1840 0.5560],呈深紫色

(0.4660 0.6740 0.1880) “# 77 ac30”

样品RGB三联体[0.4660 0.6740 0.1880],呈中绿色

(0.3010 0.7450 0.9330) “# 4 dbeee”

样品RGB三片[0.3010 0.7450 0.9330],显示为浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三元组样本[0.6350 0.0780 0.1840],呈暗红色

互动

全部展开

可见性状态,指定为“上”或者“关闭”,或数字或逻辑1真的)或0).的值“上”相当于真的, 和“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “上”- 显示对象。

  • “关闭”-隐藏对象而不删除它。您仍然可以访问不可见的UI组件的属性。

要使你的应用程序启动得更快,请设置可见财产“关闭”对于不需要在启动时显示的所有UI组件。

下拉组件的可编辑状态指定为“关闭”或者“上”,或数字或逻辑1真的)或0).的值“上”相当于真的, 和“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

如果使能够物业价值是“关闭”,然后,即使可编辑属性值是,应用程序用户也无法更改下拉组件文本“上”

运营状态,指定为“上”或者“关闭”,或数字或逻辑1真的)或0).的值“上”相当于真的, 和“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • 如果将此属性设置为“上”,应用程序用户可以与组件进行交互。

  • 如果将此属性设置为“关闭”,该组件显示为暗淡,指示应用程序用户无法与之交互,并且它不会触发回调。

工具提示,指定为字符向量、字符向量的单元格数组、字符串数组或1-D分类数组。当用户在运行时将指针悬停在组件上时,使用此属性显示消息。即使组件被禁用,工具提示也会显示出来。若要显示多行文本,请指定字符向量单元格数组或字符串数组。数组中的每个元素变成一行单独的文本。如果将此属性指定为类别数组,MATLAB将使用数组中的值,而不是全部类别集合。

上下文菜单,指定为快捷菜单使用uicontextmenu函数。在组件上单击右键时,使用此属性显示上下文菜单。

位置

全部展开

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

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

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

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

例子:[100 100 100 22]

下拉部件的内部位置和大小,指定为[左下角宽度高度].位置值相对于父容器。所有的测量都以像素为单位。该属性值与位置下拉组件。

此属性是只读的。

返回的下拉组件的外部位置和大小[左下角宽度高度].位置值相对于父容器。所有的测量都以像素为单位。该属性值与位置下拉组件。

布局选项,指定为aGridLayoutOptions对象。此属性为网格布局容器的子组件指定选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,不起作用。但是,如果组件是网格布局容器的子组件,则可以通过设置属性GridLayoutOptions对象。

例如,这段代码在其父网格的第三行和第二列中放置了一个下拉列表。

G = uigridlayout([4 3]);dd = uidropdown (g);dd.Layout.Row = 3;dd.Layout.Column = 2;

要使下拉列表跨越多行或多列,请指定或者属性作为双元素矢量。例如,此下拉跨度跨度列2通过3.

dd.layout.column = [2 3];

回调

全部展开

Value changed callback,指定为以下值之一:

  • 功能手柄。

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

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

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

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

控件的属性如下表所示ValueChangedData对象。

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

指示回调是否由于在下拉组件中键入新值而执行的逻辑值。

  • 0) -应用程序用户选择或输入的元素项目属性。

  • 1真的) -应用程序用户输入的值不是元素项目属性。

执行回调的组件。
EventName “ValueChanged”

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

下拉菜单打开回调函数,指定为其中一个值:

  • 功能手柄。

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

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

此属性指定在用户单击以打开下拉菜单时要执行的回调函数。对此回调的可能使用是动态更新下拉菜单中的条目列表。

这个回调函数可以访问关于用户与下拉列表交互的特定信息。MATLAB将这个信息传递到DropDownOpeningData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,event.source.返回落下对象,用户与之交互以触发回调。的DropDownOpeningData对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示DropDownOpeningData对象。

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

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

对象创建函数,指定为以下值之一:

  • 函数处理。

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

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

有关将回调作为函数句柄,小区阵列或字符向量的更多信息,请参阅在应用程序设计器中编写回调

此属性指定MATLAB创建对象时要执行的回调函数。MATLAB在执行之前初始化所有属性值CreateFcn回调。如果不指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设置CreateFcn现有组件上的属性无效。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo.访问对象的函数。

对象删除函数,指定为以下值之一:

  • 函数处理。

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

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

有关将回调作为函数句柄,小区阵列或字符向量的更多信息,请参阅在应用程序设计器中编写回调

此属性指定当MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前回调。如果不指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问要删除的对象。否则,使用gcbo.访问对象的函数。

回调执行控制

全部展开

回调中断,指定为“上”或者“关闭”,或数字或逻辑1真的)或0).的值“上”相当于真的, 和“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

此属性确定是否可以中断正在运行的回调。有两种回调状态需要考虑:

  • 跑步回调是当前正在执行的回调。

  • 打断Callback是一个试图中断正在运行的回调的回调。

每当执行处理回调队列的命令时,MATLAB确定回调中断行为。这些命令包括drawnow数字Uifigure.GetFrame.等待, 和暂停

如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后执行中断回调。

如果正在运行的回调函数确实包含这些命令之一,则可中断拥有正在运行的回调的对象的属性决定中断是否发生:

  • 如果可中断“关闭”,则不发生中断。相反,BusyAction属性决定中断回调是否被丢弃或添加到回调队列中。

  • 如果可中断“上”,则中断发生。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB将继续执行正在运行的回调。

请注意

在这些情况下,回调中断和执行情况不同:

  • 如果中断回调是一个DeleteFcnCloseRequestFcn, 或者SizechangedFCN.回调,则中断发生不管可中断适当的价值。

  • 如果正在运行的回调函数正在执行等待函数,则不管可中断适当的价值。

  • 如果中断回调属于计时器对象,然后回调根据时间表执行可中断适当的价值。

请注意

当中断发生时,MATLAB不保存属性或显示的状态。方法返回的对象gca或者gcf命令可能在执行另一个回调时更改。

标准队列,指定为“队列”或者“取消”.的BusyAction属性决定了MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 跑步回调是当前正在执行的回调。

  • 打断Callback是一个试图中断正在运行的回调的回调。

BusyAction属性仅在满足这两个条件时确定回调排队行为:

在这些条件下BusyAction拥有中断回调的对象的属性确定MATLAB如何处理中断回调。这些是可能的值BusyAction财产:

  • “队列”- 将中断回调在运行回调完成后在队列中进行处理。

  • “取消”—不执行中断回呼。

此属性是只读的。

删除状态,返回类型为开/关逻辑值matlab.lang.OnOffSwitchState

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted属性仍然设置为“上”直到组件对象不再存在。

检查价值BeingDeleted属性来验证对象在查询或修改之前不会被删除。

父母/孩子

全部展开

父容器,指定为数字使用Uifigure.函数或其子容器之一:选项卡面板ButtonGroup, 或者GridLayout.如果没有指定容器,则MATLAB调用Uifigure.函数创建一个新的数字用作父容器的对象。

对象句柄的可见性,指定为“上”“回调”, 或者“关闭”

此属性控制对象在其父的子列表中的可见性。当一个对象在其父的子列表中不可见时,通过搜索对象层次结构或查询属性获取对象的函数不会返回该对象。这些功能包括得到findobj.clf, 和关闭.对象即使不可见也是有效的。如果你可以访问一个对象,你可以设置和获取它的属性,并将它传递给任何操作对象的函数。

HandleVisibility价值 描述
“上” 该对象始终可见。
“回调” 从回调或通过回调调用的函数中可以看到该对象,但不是从命令行调用的函数中。此选项会阻止在命令行处访问对象,但允许回调函数访问它。
“关闭” 对象始终是不可见的。此选项对于防止其他函数对UI的意外更改非常有用。设定Huppervisibility.“关闭”在函数执行期间暂时隐藏对象。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“uidropdown”

对象标识符,指定为字符向量或字符串标量。你可以指定一个唯一的标签值作为对象的标识符。当您需要访问代码中的其他地方的对象时,可以使用findobj.函数搜索对象标签价值。

用户数据,指定为任何MATLAB阵列。例如,您可以指定标量,向量,矩阵,单元格数组,字符数组,表或结构。使用此属性在对象上存储任意数据。

如果您在App Designer中工作,请在应用程序中创建公共或私有属性以共享数据而不是使用用户数据财产。有关更多信息,请参见在应用程序设计器应用程序中共享数据

另请参阅

功能

介绍了R2016a