Toolbar
工具栏 UI 组件
说明
工具栏 UI 组件在图窗窗口顶部显示水平按钮列表。在创建工具栏后，使用 Toolbar 对象修改其外观和行为。
创建对象
使用 uitoolbar 函数在图窗中创建一个工具栏。
属性
颜色
背景颜色，指定为 RGB 三元组、十六进制颜色代码或下表中列出的颜色选项之一。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]范围内，例如[0.4 0.6 0.7]。十六进制颜色代码是字符向量或字符串标量，以井号 (
#) 开头，后跟三个或六个十六进制数字，范围可以是0到F。这些值不区分大小写。因此，颜色代码"#FF8800"与"#ff8800"、"#F80"与"#f80"是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
交互性
设置此属性对此类型的对象没有影响。
回调
回调执行控件
父级/子级
父对象，指定为 Figure 对象。如果未指定父图窗，则 MATLAB 调用 figure 函数以创建一个图窗来用作父图窗。
通过将此属性设置为目标 Figure 对象，可将 Toolbar 对象移到不同的图窗中。
Toolbar 的子级，以空 GraphicsPlaceholder 或组件对象的一维数组形式返回。Toolbar 对象的子级是 PushTool 和 ToggleTool 对象。
不能使用 Children 属性添加或删除子级。使用该属性查看子级列表或对子级重新排序。此数组中子级的顺序反映了工具在工具栏中从右到左的显示顺序。这意味着最右边的工具在列表的顶部，最左边的工具在列表的底部。例如，由 Children 属性返回的此工具顺序表示按钮工具出现在工具栏中切换工具的左侧。
toolOrder = tb.Children
toolOrder = 2×1 graphics array: ToggleTool PushTool
要向该列表中添加子级，请将子组件的 Parent 属性设置为 Toolbar 对象。
HandleVisibility 属性设置为 'off' 的对象不会列在 Children 属性中。
对象句柄的可见性，指定为 'on'、'callback' 或 'off'。
此属性控制对象在其父级的子级列表中的可见性。当对象未显示在其父级的子级列表中时，通过搜索对象层次结构或查询属性来获取对象的函数不会返回该对象。这些函数包括 get、findobj、gca、gcf、gco、newplot、cla、clf 和 close。HandleVisibility 属性还控制对象句柄是否显示在父图窗的 CurrentObject 属性中。对象即使在不可见时也有效。如果可以访问某个对象，则可以设置和获取其属性，并将其传递给针对对象进行运算的任意函数。
| HandleVisibility 值 | 描述 |
|---|---|
'on' | 对象句柄始终可见。 |
'callback' | 对象句柄在回调或回调所调用的函数中可见，但在从命令行调用的函数中不可见。此选项阻止通过命令行访问对象，但允许回调函数访问对象。 |
'off' | 对象句柄始终不可见。该选项用于防止另一函数无意中对 UI 进行更改。将 HandleVisibility 设置为 'off' 可在执行该函数时暂时隐藏句柄。 |
标识符
此 属性 为只读。
图形对象的类型，以 'uitoolbar' 形式返回。
示例
更改工具栏中从左到右的工具顺序。在本例中，颠倒 UI 图窗工具栏中按钮工具和切换工具的顺序。
创建一个 UI 图窗。向其中添加一个工具栏。然后，在工具栏中添加按钮工具和切换工具。
fig = uifigure; tb = uitoolbar(fig); pt = uipushtool(tb); tt = uitoggletool(tb);
在工具栏中创建一个按钮工具。将 Icon 属性值设置为图像文件 matlabicon.gif。
pt.Icon = fullfile(matlabroot,'toolbox','matlab','icons','matlabicon.gif');
创建一个蓝色真彩色图像数组。将 Icon 属性值设置为此数组，以在切换工具中显示蓝色方形图标。
ttImage = zeros(16,16,3); ttImage(:,:,3) = ones(16); tt.Icon = ttImage;
查询工具栏的 Children 属性。在此数组中返回的子级的顺序反映了工具在工具栏中从右到左的显示顺序。切换工具是最右边的工具，出现在列表的顶部（数组的第一个元素）。
oldToolOrder = tb.Children
oldToolOrder = 2×1 graphics array: ToggleTool PushTool
通过调用 flipud 函数翻转在 tb.Children 返回的数组中元素的顺序，以颠倒工具的顺序。将 Children 属性值设置为此新工具顺序。按钮工具现在出现在工具栏中切换工具的右侧。
newToolOrder = flipud(oldToolOrder); tb.Children = newToolOrder;
