TreeNode
树节点 UI 组件
说明
树节点 UI 组件在 App 内的树层次结构中显示项目。在创建树节点后，使用 TreeNode 对象修改其外观和行为。
创建对象
使用 uitreenode 函数在 App 中创建一个树节点。
属性
示例
创建一个按运动项目分组显示运动员姓名的 App。当 App 用户点击一个姓名时，MATLAB 会显示该运动员的相关数据。
创建一个名为 mytreeapp.m 的程序文件，并在其中包含下列代码，以创建树、一组嵌套的树节点和一个回调函数。SelectionChangedFcn 属性指定当用户点击树中的节点时要执行的函数。
function mytreeapp fig = uifigure; t = uitree(fig,"Position",[20 20 150 150]); % Assign callback in response to node selection t.SelectionChangedFcn = @nodechange; % First level nodes category1 = uitreenode(t,"Text","Runners","NodeData",[]); category2 = uitreenode(t,"Text","Cyclists","NodeData",[]); % Second level nodes. % Node data is age (y), height (m), weight (kg) p1 = uitreenode(category1,"Text","Joe","NodeData",[40 1.67 58] ); p2 = uitreenode(category1,"Text","Linda","NodeData",[49 1.83 90]); p3 = uitreenode(category2,"Text","Rajeev","NodeData",[25 1.47 53]); p4 = uitreenode(category2,"Text","Anne","NodeData",[88 1.92 100]); % Expand the tree expand(t); % Create the function for the SelectionChangedFcn callback % When the function is executed, it displays the data of the selected item function nodechange(src,event) node = event.SelectedNodes; display(node.NodeData); end end
当用户运行 mytreeapp 并点击树中的节点时，MATLAB 将显示该节点的 NodeData。
创建一个基于表中数据填充节点的树。
使用网格布局管理器创建一个图窗来容纳 UI 组件。加载电力公司停电的采样数据，并创建一个表 UI 组件来显示该数据。然后，创建一个树来容纳列出断电区域和原因的节点。
fig = uifigure;
gl = uigridlayout(fig,[1 2]);
gl.ColumnWidth = {'2x','1x'};
T = readtable("outages.csv");
T = T(1:20,["Region","OutageTime","Loss","Cause"]);
tbl = uitable(gl,"Data",T);
tr = uitree(gl);指定要在树中显示的表变量。对于其中每一个变量，创建一个顶层节点，其文本就是变量名称。通过将变量的表条目转换为分类数组并将分类列表返回为 names，提取相关数据。然后，遍历各类别。对于每个元素，向树中适当的父节点下添加一个节点。
vars = ["Region","Cause"]; for k1 = 1:length(vars) var = vars{k1}; varnode = uitreenode(tr,"Text",var); rows = T{:,var}; names = categories(categorical(rows)); for k2 = 1:length(names) text = names{k2}; uitreenode(varnode,"Text",text); end end
展开树以查看所有节点。
expand(tr)
为树组件创建一个上下文菜单。将该上下文菜单分配给树中的所有顶层节点。
在当前文件夹的新脚本中，创建一个 UI 图窗。然后，创建一个树，其中包含四个顶层节点和一组嵌套节点。
fig = uifigure; t = uitree(fig,"Position",[20 200 175 100]); category1 = uitreenode(t,"Text","Runners"); r1 = uitreenode(category1,"Text","Joe"); r2 = uitreenode(category1,"Text","Linda"); category2 = uitreenode(t,"Text","Cyclists"); c1 = uitreenode(category2,"Text","Rajeev"); category3 = uitreenode(t,"Text","Hikers"); h1 = uitreenode(category3,"Text","Jack"); category4 = uitreenode(t,"Text","Swimmers"); s1 = uitreenode(category4,"Text","Logan");
创建一个上下文菜单，其中包含一个菜单项和两个子菜单，用户可以点击该上下文菜单来展开单个树节点或所有树节点。对于每个子菜单，指定当用户选择菜单选项时要执行的 MenuSelectedFcn 回调函数。将相关的 App 对象作为输入传递给每个函数，以便从回调函数中访问 App 数据。
cm = uicontextmenu(fig); m1 = uimenu(cm,"Text","Expand..."); sbm1 = uimenu(m1,"Text","This Node", ... "MenuSelectedFcn",{@expandSingle,fig}); sbm2 = uimenu(m1,"Text","All Nodes", ... "MenuSelectedFcn",{@expandAll,t});
通过将每个节点的 ContextMenu 属性设置为 ContextMenu 对象，将上下文菜单分配给顶层树节点。
category1.ContextMenu = cm; category2.ContextMenu = cm; category3.ContextMenu = cm; category4.ContextMenu = cm;
在文件的底部，定义 expandSingle 和 expandAll 回调函数。定义函数来接受 MATLAB 传递给所有回调函数的源和事件数据。
定义 expandSingle 函数来同时接受包含树的 UI 图窗对象，并使用图窗的 CurrentObject 属性来确定点击哪个树节点来显示上下文菜单。然后，展开该节点。
定义 expandAll 函数来同时接受树对象，并展开树中的所有节点。
function expandSingle(src,event,f) node = f.CurrentObject; expand(node) end function expandAll(src,event,t) expand(t) end
保存并运行脚本。右键点击任一顶层树节点可查看上下文菜单。
版本历史记录
在 R2017b 中推出
