主要内容

树的属性

控制树的外观和行为

树是UI组件,用于在应用程序的层次结构中显示项目列表。属性控制树的外观和行为。使用点表示法来指代特定的对象和属性。

例如,这段代码创建了一个具有两个嵌套节点的基本树,存储对象作为t,然后设置FontColor属性使用点符号。

图= ufigfig;T = uitree(fig);N1 = uitreenode(t);n1。文本= '节点1';N2 = uitreenode(n1);n2。文本= '节点2';t.FontColor = 'blue';

有关如何创建和配置树的更多示例,请参见uitree

节点

全部展开

所选节点,指定为TreeNode对象或的数组TreeNode对象。使用此属性可获取或设置树中的选定节点。

若要允许用户选择多个节点,请设置多选财产“上”.MATLAB®总是返回SelectedNodes当树有多个选中节点时,作为列向量。

字体和颜色

全部展开

字体名称,指定为系统支持的字体名称。金宝app默认字体取决于特定的操作系统和地区。

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

例子:“天线”

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

例子:14

字体重量,指定为以下值之一:

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

  • “大胆”-较粗的字符轮廓“正常”

并非所有字体都有粗体字体权重。对于不需要的字体,指定“大胆”结果在正常字体权重。

字体角度,指定为“正常”“斜体”.不是所有字体都有斜体字体角度。对于不需要的字体,指定“斜体”结果在正常字体角度。

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

RGB三联色和十六进制色码用于指定自定义颜色。

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

  • 十六进制颜色码是字符向量或以散列符号()之后是三个或六个十六进制数字,取值范围从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” ‘g’ [0 1 0] “# 00 ff00”

样品的颜色为绿色

“蓝” “b” [0 0 1] “# 0000 ff”

蓝色的样品

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “米” [10 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]

  • 十六进制颜色码是字符向量或以散列符号()之后是三个或六个十六进制数字,取值范围从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” ‘g’ [0 1 0] “# 00 ff00”

样品的颜色为绿色

“蓝” “b” [0 0 1] “# 0000 ff”

蓝色的样品

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “米” [10 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],呈暗红色

此属性是只读的。

控件创建的已添加样式的配置uistyle函数,作为n表数组。表数组的每一行都对应于当前应用于树的样式。连续添加的样式的样式顺序编号为n + 1.的目标而且TargetIndex列指定将样式添加到树的哪个部分。的风格列指定样式类名。

方法从树中删除样式时,请使用此属性removeStyle函数。

示例:删除一个样式

首先,向树中添加两种样式。

图= ufigfig;fig.Position = [100 100 250 350];T = uitree(fig);N1 = uitreenode(t,“文本”“水果”);N11 = uitreenode(n1,“文本”“香蕉”);N12 = uitreenode(n1,“文本”“樱桃”);N2 = uitreenode(t,“文本”“蔬菜”);N21 = uitreenode(n2,“文本”“西兰花”);N22 = uitreenode(n2,“文本”“莴苣”);展开(t) s1 = uistyle(“FontColor”,[0 0.4 0.7]);%绿色S2 = uistyle(“FontColor”,[0.1 0.5 0.1]);%的蓝色addStyle (t, s1,“水平”2);addStyle (t, s2,“节点”,[n2 n21 n22]);

树的节点上列出了水果和蔬菜。香蕉和樱桃节点为蓝色,蔬菜、西兰花和生菜节点为绿色。

当您查询时t.StyleConfigurations, MATLAB返回一个2 × 3的表数组。关卡样式首先被添加到表格UI组件中,所以它是样式顺序号1.的TargetIndex值为关卡样式,{[2]},表示该样式应用于第二层节点。类似地,第二种样式被添加到树中的三个节点。

t.StyleConfigurations
ans = 2×3表目标TargetIndex风格  ______ ______________ _________________________ 1级{[2]}1×1 matlab.ui.style.Style 2节点{1×3 TreeNode} 1×1 matlab.ui.style.Style

通过指定样式顺序号,删除添加到树中的第二个样式2.树组件外观更新为只使用第一种样式。

removeStyle (t, 2)

树的节点上列出了水果和蔬菜。香蕉、樱桃、西兰花和生菜节点为蓝色。

交互性

全部展开

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

  • “上”—显示对象。

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

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

多个节点选择,指定为“关闭”“上”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

将此属性设置为“上”允许用户同时选择多个节点。

节点文本可编辑性,指定为“关闭”“上”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

将此属性设置为“上”允许用户在运行时编辑节点文本。的启用属性也必须设置为“上”使文本可编辑。

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

  • 如果将此属性设置为“上”,应用程序用户可以与树及其节点交互。

  • 如果将此属性设置为“关闭”,该组件显示为灰色,表明应用程序用户不能与它或它的节点交互,并且它不会触发回调。

将此属性设置为“关闭”使树及其节点显示为暗淡状态,表示用户无法与树或其节点交互。

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

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

位置

全部展开

位置和大小,指定为表单的四元素向量[左底宽高].这个表描述了向量中的每个元素。所有的测量都以像素为单位。

元素 描述
从父容器的左内边缘到包围树的边界框的左边缘的距离
父容器的内底边到包围树的边界框底边的距离
宽度 边界框的左右边缘之间的距离
高度 边界框的顶部和底部边缘之间的距离

位置和大小,指定为形式的四元素向量,[左底宽高].vector中的值是相对于父容器的。所有的测量都以像素为单位。属性值与位置财产。

此属性是只读的。

位置和大小,作为形式的四元素向量返回,[左底宽高].vector中的值是相对于父容器的。所有的测量都以像素为单位。属性值与位置财产。

布局选项,指定为GridLayoutOptions对象。此属性为网格布局容器的子组件指定选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,没有任何效果。但是,如果组件是网格布局容器的子组件,则可以将组件放置在网格的所需行和列中而且的属性GridLayoutOptions对象。

例如,这段代码将树放在其父网格的第三行和第二列中。

G = uigridlayout([4 3]);T = uitree(g);t.Layout.Row = 3;t.Layout.Column = 2;

要使树跨越多行或多列,请指定属性作为双元素向量。例如,此树跨越列2通过3.

t.Layout.Column = [2 3];

回调

全部展开

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

  • 函数句柄。

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

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

当用户选择树中的不同节点时,使用此回调函数执行命令。

这个回调函数可以访问关于用户与树交互的特定信息,例如所选节点。MATLAB将此信息传递到SelectedNodesChangedData对象作为回调函数的第二个参数。在App Designer中,这个参数被调用事件.可以使用点表示法查询对象属性。例如,事件。选择edNodes返回选定的TreeNode对象或对象。的SelectedNodesChangedData对象不能用于指定为字符向量的回调函数。

属性的属性描述如下表SelectedNodesChangedData对象。

财产

描述

SelectedNodes

最近入选的TreeNode对象或多个对象

PreviousSelectedNodes

之前的选择TreeNode对象或多个对象

执行回调的组件

EventName

“SelectionChanged”

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

节点扩展回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户展开树中的节点时,使用此回调函数执行命令。

这个回调函数可以访问关于用户与节点交互的特定信息。MATLAB将此信息传递到NodeExpandedData对象作为回调函数的第二个参数。在App Designer中,这个参数被调用事件.可以使用点表示法查询对象属性。例如,事件。节点返回TreeNode对象,用户已折叠。的NodeExpandedData对象不能用于指定为字符向量的回调函数。

属性的属性描述如下表NodeExpandedData对象。

财产

描述

节点

TreeNode对象

执行回调的组件

EventName

“NodeExpanded”

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

节点折叠回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户折叠树中的节点时,使用此回调函数执行命令。

这个回调函数可以访问关于用户与节点交互的特定信息。MATLAB将此信息传递到NodeCollapsedData对象作为回调函数的第二个参数。在App Designer中,这个参数被调用事件.可以使用点表示法查询对象属性。例如,事件。节点返回TreeNode对象,用户已折叠。的NodeCollapsedData对象不能用于指定为字符向量的回调函数。

属性的属性描述如下表NodeCollapsedData对象。

财产

描述

节点

TreeNode对象,用户已折叠

执行回调的组件

EventName

“NodeCollapsed”

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

节点文本更改回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户更改树中节点的文本时,使用此回调函数执行命令。

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

的属性说明如下表所示NodeTextChangedData对象。

财产

描述

节点

TreeNode对象更改了文本

文本

新节点文本

PreviousText

以前的节点文本

执行回调的组件

EventName

“NodeTextChanged”

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

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

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

设置CreateFcn属性对现有组件没有影响。

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

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

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

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

回调执行控制

全部展开

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

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

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

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

MATLAB在执行处理回调队列的命令时确定回调中断行为。这些命令包括drawnow数字uifiguregetframe等待,暂停

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

如果正在运行的回调函数包含这些命令中的一个,则可中断属性的值确定中断是否发生:

  • 的值可中断“关闭”,则不会出现中断。相反,BusyAction属性的属性确定中断回调是被丢弃还是被添加到回调队列。

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

请注意

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

  • 如果中断回调函数是DeleteFcnCloseRequestFcn,或SizeChangedFcn回调函数,则中断发生而不管可中断属性值。

  • 如果正在运行的回调函数当前正在执行等待函数,则中断发生而不管可中断属性值。

  • 如果中断回调函数属于计时器对象,则回调函数将根据调度执行,而不考虑可中断属性值。

请注意

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

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

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

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

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

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

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

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

此属性是只读的。

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

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

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

父/子

全部展开

父容器,指定为数字对象创建的。uifigure函数或它的子容器之一:选项卡面板ButtonGroup,或GridLayout.如果没有指定容器,MATLAB调用uifigure函数来创建一个新的数字对象,它充当父容器。

孩子们,作为数组返回TreeNode对象。

方法无法添加或删除子节点孩子们属性,但可以使用该属性查看子列表。子节点的顺序反映了屏幕上显示的子节点的顺序。若要向此列表添加子对象,请设置属性的子组件对象。

要重新排列子节点,请使用移动函数。

具有HandleVisibility属性设置为“关闭”都没有列在孩子们财产。

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

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

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

标识符

全部展开

此属性是只读的。

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

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

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

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

另请参阅

功能

在R2017b中引入