主要内容

列表框属性

控制列表框外观和行为

列表框的UI组件显示在一个列表上的项目。属性控制一个列表框的外观和行为。使用点符号来引用一个特定的对象和属性:

无花果= uifigure;= uilistbox列表(图);列表。项目= {'Red','Green','Blue'};

列表框

全部展开

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

指定没有选择,集价值一个空单元数组。

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

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

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

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

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

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

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

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

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

例子:20 30 40 [10]

字体和颜色

全部展开

字体名称,指定为一个系统支持字体名称。万博1manbetx默认字体取决于具体的操作系统和语言环境。

如果指定的字体不可用,然后用MATLAB使用字体之间的最佳匹配的系统上可用的应用程序正在运行。

例子:“天线”

字体大小,指定为一个正数。测量的单位是像素。默认字体大小取决于具体的操作系统和语言环境。

例子:14

字体的体重,指定这些值之一:

  • “正常”违约重量所定义的特定的字体

  • “大胆”——厚字符轮廓“正常”

不是所有的字体都有一个大胆的字体的重量。字体不指定“大胆”结果在正常字体的重量。

字体角,指定为“正常”“斜体”。不是所有的字体斜体字体角。字体不指定“斜体”结果在正常字体角。

字体颜色、指定为一个RGB值,十六进制的颜色代码,或者表中列出的选项之一。

RGB三胞胎和十六进制颜色代码可用于指定自定义颜色。

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

  • 十六进制颜色代码是一个特征向量或一个字符串标量,始于一个散列符号(#)后面跟着三个月或六个十六进制数字,它的范围可以从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飞行符”

样品的颜色青色

“红色” “m” (1 0 1) “#”就

样品的颜色红色

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

样品的颜色黄色

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

样品的颜色黑色

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

样品的颜色白色

这是默认颜色的RGB三胞胎和十六进制颜色编码MATLAB使用在许多类型的情节。

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)

  • 十六进制颜色代码是一个特征向量或一个字符串标量,始于一个散列符号(#)后面跟着三个月或六个十六进制数字,它的范围可以从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飞行符”

样品的颜色青色

“红色” “m” (1 0 1) “#”就

样品的颜色红色

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

样品的颜色黄色

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

样品的颜色黑色

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

样品的颜色白色

这是默认颜色的RGB三胞胎和十六进制颜色编码MATLAB使用在许多类型的情节。

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

  • 如果你设定这个属性“上”,应用程序用户可以与组件交互。

  • 如果你设定这个属性“关闭”,组件似乎黯淡,表明应用程序用户不能与它交互,而且它不会触发一个回调。

工具提示,指定为一个特征向量,单元阵列的特征向量,字符串数组,或一维分类数组。使用这个属性来显示一个消息当用户将鼠标悬停于指针组件在运行时。工具提示显示即使组件是禁用的。显示多行文本,指定一个单元阵列特征向量或一个字符串数组。数组中的每个元素,成为一个单独的行文本。如果指定这个属性作为分类数组,MATLAB使用数组中的值,而不是完整的类别。

指定为一个上下文菜单快捷菜单对象创建使用uicontextmenu函数。使用这个属性来显示一个上下文菜单,当你右键单击一个组件。

位置

全部展开

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

元素 描述
内左边缘的距离外父容器的列表框的左边缘
的距离内底边缘父容器的外底列表框的边缘
宽度 距离左边和右边列表框的外缘
高度 顶部和底部之间的距离外边缘的列表框

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

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

例子:(100 100 100 200)

内心的位置和大小的列表框,指定为(左底宽高)。值都是相对于父容器的位置。所有的测量都是在像素单元。这个属性值是相同的位置财产。

这个属性是只读的。

返回的列表框外的位置和大小(左底宽高)。值都是相对于父容器的位置。所有的测量都是在像素单元。这个属性值是相同的位置财产。

布局选项,指定为一个GridLayoutOptions对象。这个属性指定组件的选项的网格布局容器。如果组件不是孩子的网格布局容器(例如,它是一个孩子的图或面板),然后这个属性是空的,没有任何影响。然而,如果组件是一个孩子的网格布局容器,您可以将组件所需的行和列的网格通过设置属性GridLayoutOptions对象。

例如,这段代码的地方一个列表框在第三行和第二列的网格。

3 g = uigridlayout ([4]);列表= uilistbox (g);list.Layout。行= 3;list.Layout。列= 2;

列表框的跨越多个行或列,指定房地产作为一个双元素向量。例如,这个列表框列2通过3:

list.Layout。列= [2 3];

回调

全部展开

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

  • 一个处理函数。

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

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

这个回调函数执行当用户选择一个不同的项目在列表框。如果它不执行价值属性设置以编程方式更改。

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

下表列出的属性ValueChangedData对象。

财产 价值
价值 后的值列表框应用用户最近的交互
PreviousValue 列表框的价值之前,应用程序用户最近的交互
组件执行回调
EventName “ValueChanged”

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

点击回调,指定这些值之一:

  • 一个处理函数。

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

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

这个回调函数执行当用户单击列表框的任何地方。

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

此表列出的属性ClickedData对象。

财产 价值
InteractionInformation

信息的组件应用程序用户点击。这些信息被存储为一个对象与这些属性:

  • ScreenLocation

  • 位置

你可以查询对象属性使用点符号。例如,event.InteractionInformation.Item返回条目的列表框用户点击。

组件执行回调
EventName “点击”

此表列出的属性InteractionInformation与列表框组件相关联的对象。

财产 价值

点击列表框项指数,作为一个标量返回。

如果用户点击列表框的面积与一个项目没有联系,是一个空数组。

ScreenLocation

用户点击的位置相对于手机的左下角时他们的主要显示,作为一个双元素向量的形式返回(x, y)

的价值x代表水平距离的左边缘显示点击的位置。的价值y代表的垂直距离底部边缘显示点击的位置。距离是以像素。

位置

位置相对于手机的左下角时用户点击列表框父容器,作为一个双元素向量的形式返回(x, y)

的价值x代表的水平距离父容器的左边缘点的位置。的价值y代表了垂直距离父容器的底部边缘点的位置。距离是以像素。

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

例如:点击列表框时打开的窗口

创建一个列表框项代表颜色。指定一个ClickedFcn回调函数命名openWindow当用户执行单击列表框。在openWindow功能:

  • 使用event.InteractionInformation对象来访问用户是否点击一个条目的信息。

  • 如果用户点击一个条目(而不是一个位置的列表框中不与一个项目相关的),查询用户点击的位置和颜色与点击项关联。

  • 打开一个新窗口的项目颜色用户点击的位置。

尝试这个例子中,将代码保存在一个新的脚本并运行它。点击一个条目的列表框中打开一个新窗口。

无花果= uifigure;磅= uilistbox(图);lb.Items = [“红色”,“黄色”,“蓝色”];lb.ItemsData = [“r”,“y”,“b”];lb.ClickedFcn = @openWindow;函数openWindow(磅、事件)idx = event.InteractionInformation.Item;如果~ isempty (idx) p = event.InteractionInformation.ScreenLocation;颜色= lb.ItemsData (idx);图= uifigure (“位置”,(150年150页));图二:颜色=颜色;结束结束

双击回调,指定这些值之一:

  • 一个处理函数。

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

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

这个回调函数执行时在用户双击列表框的任何地方。

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

此表列出的属性DoubleClickedData对象。

财产 价值
InteractionInformation

信息的组件应用程序用户点击。这些信息被存储为一个对象与这些属性:

  • ScreenLocation

  • 位置

你可以查询对象属性使用点符号。例如,event.InteractionInformation.Item返回条目的列表框,用户双击运行。

组件执行回调
EventName “双击”

此表列出的属性InteractionInformation与列表框组件相关联的对象。

财产 价值

双击列表框项指数,作为一个标量返回。

如果用户双击列表框的面积与一个项目没有联系,是一个空数组。

ScreenLocation

的位置,用户双击运行相对于手机的左下角时他们的主要显示,作为一个双元素向量的形式返回(x, y)

的价值x代表水平距离的左边缘显示双击位置。的价值y代表的垂直距离底部边缘显示双击位置。距离是以像素。

位置

位置相对于手机的左下角时用户双击列表框父容器,作为一个双元素向量的形式返回(x, y)

的价值x代表左边缘的水平距离双击父容器的位置。的价值y代表了垂直距离父容器的底部边缘点的位置。距离是以像素。

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

例如:当列表框双击打开窗口

创建一个列表框项代表颜色。指定一个DoubleClickedFcn回调函数命名openWindow当用户双击列表框执行。在openWindow功能:

  • 使用event.InteractionInformation对象来访问信息是否用户双击一个项目。

  • 如果用户双击一个项目(而不是一个位置的列表框中不与一个项目相关的),查询用户双击的位置和颜色与双击项关联。

  • 打开一个新窗口的项目颜色的位置,用户双击运行。

尝试这个例子中,将代码保存在一个新的脚本并运行它。双击列表框中的一个条目,打开一个新窗口。

无花果= uifigure;磅= uilistbox(图);lb.Items = [“红色”,“黄色”,“蓝色”];lb.ItemsData = [“r”,“y”,“b”];lb.DoubleClickedFcn = @openWindow;函数openWindow(磅、事件)idx = event.InteractionInformation.Item;如果~ isempty (idx) p = event.InteractionInformation.ScreenLocation;颜色= lb.ItemsData (idx);图= uifigure (“位置”,(150年150页));图二:颜色=颜色;结束结束

对象创建函数,指定这些值之一:

  • 函数处理。

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

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

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

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

设置CreateFcn属性在一个现有的组件没有影响。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被创建使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

对象删除函数,指定这些值之一:

  • 函数处理。

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

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

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

这个属性指定一个回调函数执行时MATLAB删除对象。MATLAB执行DeleteFcn回调之前破坏对象的属性。如果你不指定DeleteFcn属性,然后MATLAB默认执行删除功能。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被删除使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

回调执行控制

全部展开

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

这个属性决定了如果一个回调可以运行中断。有两种回调状态考虑:

  • 运行回调是当前执行的回调。

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

MATLAB决定调中断行为每当它执行一个命令队列处理回调。这些命令包括drawnow,,uifigure,getframe,等待,暂停

如果调不包含运行这些命令,然后没有中断发生。MATLAB首先完成执行运行回调,后来执行中断的回调。

如果跑回调也包含其中的一个命令,然后可中断对象的属性拥有运行调决定如果中断发生时:

  • 如果该值的可中断“关闭”,然后没有中断发生。相反,BusyAction对象的属性拥有打断调决定如果打断回调被丢弃或添加到队列的回调。

  • 如果该值的可中断“上”,然后中断发生。下次MATLAB处理回调队列,它停止运行的执行回调并执行中断的回调。打断调完成后,MATLAB简历执行回调。

请注意

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

  • 如果中断的回调DeleteFcn,CloseRequestFcn,或SizeChangedFcn回调,那么无论发生中断可中断属性值。

  • 如果运行目前执行的回调等待函数,那么无论发生中断可中断属性值。

  • 如果回调是由一个中断计时器对象,然后根据时间表不管回调执行可中断属性值。

请注意

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

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

  • 运行回调是当前执行的回调。

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

BusyAction属性决定了回调排队行为只有满足这两个条件:

在这种情况下,BusyAction对象的属性拥有打断调决定MATLAB如何处理中断的回调。这些都是可能的值的BusyAction属性:

  • “队列”——将中断处理回调在一个队列跑回调结束后执行。

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

这个属性是只读的。

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

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted房地产仍将“上”直到组件对象已不复存在。

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

父/子

全部展开

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

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

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

HandleVisibility价值 描述
“上” 对象总是可见的。
“回调” 对象是可见的在回调函数或函数调用回调,但不是在从命令行调用的函数。这个选项块访问对象的命令行,但是允许回调函数来访问它。
“关闭” 对象是无形的。这个选项是有用的防止意外更改UI被另一个函数。设置HandleVisibility“关闭”暂时隐藏对象在这个函数的执行。

标识符

全部展开

这个属性是只读的。

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

对象标识符指定为一个特征向量或字符串标量。您可以指定一个唯一的标签价值作为一个对象的标识符。当你需要访问对象在您的代码,您可以使用findobj基于函数搜索对象标签价值。

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

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

版本历史

介绍了R2016a

全部展开