文档

下拉的属性

(应用程序设计器)控制下拉列表外观和行为

类创建的下拉组件有效uidropdown函数。控件创建的下拉组件uicontrol功能,请参阅UIControl属性

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

F = ufigure;Dd = uidropdown(f);dd.Items ={'红色','绿色','蓝色'};

下拉

全部展开

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

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

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

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

例子:{' 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三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7].或者,您可以通过名称指定一些常用颜色。该表列出了长颜色和短颜色名称选项以及等效的RGB三元组值。

选项 描述 等效RGB三元组
“红色”“r” 红色的 [10 0 0]
“绿色”‘g’ 绿色 [0 10 0]
“蓝”“b” 蓝色的 [0 0 1]
“黄色”“y” 黄色的 [11 10 0]
“红色”“米” 品红色的 [10 0 1]
“青色”“c” 青色 [0 1 1]
“白色”' w ' 白色 [1 1 1]
“黑”“k” 黑色的 [0 0 0]

背景色,指定为RGB三元组或表中列出的颜色选项之一。

RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7].或者,您可以通过名称指定一些常用颜色。该表列出了长颜色和短颜色名称选项以及等效的RGB三元组值。

选项 描述 等效RGB三元组
“红色”“r” 红色的 [10 0 0]
“绿色”‘g’ 绿色 [0 10 0]
“蓝”“b” 蓝色的 [0 0 1]
“黄色”“y” 黄色的 [11 10 0]
“红色”“米” 品红色的 [10 0 1]
“青色”“c” 青色 [0 1 1]
“白色”' w ' 白色 [1 1 1]
“黑”“k” 黑色的 [0 0 0]

交互性

全部展开

下拉组件可见性,指定为“上”“关闭”.的可见属性确定是否在屏幕上显示下拉组件。如果可见属性设置为“关闭”,则下拉组件将被隐藏,但您仍然可以指定并访问其属性。

要使应用程序启动更快,请设置可见属性的所有组件,这些组件在启动时不需要出现“关闭”

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

如果启用属性值为“关闭”,则应用程序用户不能更改下拉组件文本,即使Editable属性值为“上”

下拉组件的操作状态,指定为“上”“关闭”

  • 如果将此属性值设置为“上”,则下拉组件的出现表明应用程序用户可以更改下拉组件的值。

  • 如果将此属性值设置为“关闭”,则下拉组件的外观显得暗淡。这个外观表明应用程序用户不能更改下拉组件的值,并且下拉组件不会触发任何回调。

位置

全部展开

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

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

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

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

例子:[100 100 100 22]

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

此属性是只读的。

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

回调

全部展开

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

  • 一个函数句柄。

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

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

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

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

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

财产 价值
价值 下拉组件值后的应用程序用户最近的互动。
PreviousValue 下拉组件的值之前的应用程序用户最近的互动。
编辑 逻辑值(0或1),指示是否由于在下拉组件中键入值而执行了回调。的编辑当应用程序用户输入下拉组件时,值为1;当应用程序用户从下拉组件中选择一个选项时,值为0。
组件执行回调。
EventName “ValueChanged”

有关编写回调函数的详细信息,请参见在应用程序设计器中编写回调

组件创建函数,指定为以下值之一:

  • 一个函数句柄。

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

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

此属性指定当MATLAB在应用程序中创建此组件时要执行的回调函数CreateFcn回调。如果没有指定CreateFcn属性,然后MATLAB执行默认的创建函数。

使用gcbo在你的CreateFcn获取正在创建的组件的代码。

设置CreateFcn属性在现有组件上不起作用。

组件删除函数,指定为以下值之一:

  • 一个函数句柄。

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

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

DeleteFcn属性指定当MATLAB删除应用程序中的组件时执行的回调函数DeleteFcn在销毁对象的属性之前。如果没有指定DeleteFcn属性,然后MATLAB执行默认删除函数。

使用gcbo在你的DeleteFcn访问正在删除的组件的代码。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”.的可中断属性确定正在运行的回调是否可以中断。

有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

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

每当MATLAB调用回调时,该回调都会试图中断正在运行的回调(如果存在的话)。的可中断拥有正在运行的回调对象的属性决定是否允许中断:

  • 值为“上”允许其他回调中断对象的回调。中断发生在MATLAB处理队列的下一个点,例如当存在drawnowuifiguregetframe等待,或暂停命令。

    • 如果正在运行的回调包含其中一个命令,那么MATLAB将在此时停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB恢复执行正在运行的回调。

    • 如果正在运行的回调不包含这些命令之一,那么MATLAB将不间断地完成回调的执行。

  • 值为“关闭”阻塞所有的中断尝试。的BusyAction拥有中断回调的对象的属性决定中断回调是被丢弃还是放入队列。

请注意

回调中断和执行在以下情况下表现不同:

  • 如果中断回调是DeleteFcnCloseRequestFcnSizeChangedFcn回调函数时,中断发生,而不管可中断属性值。

  • 方法当前正在执行等待函数,则中断发生而不管可中断属性值。

  • 计时器对象根据调度执行,而不管可中断属性值。

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

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

  • 运行Callback是当前正在执行的Callback。

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

BusyAction拥有中断回调对象的属性决定了MATLAB如何处理中断回调的执行。的BusyAction属性有两个可能的值:

  • “队列”—将中断的回调放到队列中,待正在运行的回调执行完成后再进行处理。

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

每当MATLAB调用回调时,该回调总是试图中断正在执行的回调(如果存在)。的可中断属性决定是否允许中断。的可中断属性有两个可能的值:

  • “上”-中断发生在下一个MATLAB处理队列的点。这是默认值。

  • “关闭”- - - - - -BusyAction属性(属于中断回调的对象)决定MATLAB是否排队或忽略中断回调。

此属性是只读的。

此组件的删除状态,返回为“关闭”“上”.MATLAB设置BeingDeleted财产“上”DeleteFcn回调开始执行。的BeingDeleted属性仍然设置为“上”直到组件对象不再存在。

的值BeingDeleted属性在查询或修改对象之前验证对象是否即将被删除。

父/子

全部展开

父对象,指定为数字使用uifigure函数,或者它的子容器之一:选项卡面板,或ButtonGroup

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

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

HandleVisibility价值 描述
“上” 对象总是可见的。
“回调” 对象在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行访问对象,但允许回调函数访问它。
“关闭” 这个物体在任何时候都是看不见的。此选项对于防止另一个函数对UI的意外更改非常有用。设置HandleVisibility“关闭”在函数执行期间暂时隐藏对象。

标识符

全部展开

此属性是只读的。

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

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

用户数据,指定为任意数组。指定用户数据对于在以编程方式创建的应用程序中共享数据非常有用。

请注意

不要在使用应用程序设计器创建的应用程序中使用此属性。有关在App Designer应用程序中共享数据的信息,请参见在应用设计器应用中共享数据

另请参阅

功能

在R2016a中引入

这个话题有用吗?