axtoolbarbtn

向坐标区工具栏添加按钮

自 R2018b 起

全页折叠

语法

btn = axtoolbarbtn(tb)

btn = axtoolbarbtn(tb,style)

btn = axtoolbarbtn(tb,style,Name,Value)

说明

btn = axtoolbarbtn(tb) 将普通按钮添加到 tb 指定的坐标区工具栏，并返回 ToolbarPushButton 对象。

示例

btn = axtoolbarbtn(tb,style) 将普通按钮或状态按钮添加到 tb 指定的工具栏，并返回按钮对象。对于普通按钮，将样式设置为 'push'。对于具有两种状态的状态按钮，将样式设置为 'state'。

btn = axtoolbarbtn(tb,style,Name,Value) 使用一个或多个名称-值对组参数指定按钮属性。

示例

全部折叠

向工具栏添加状态按钮

为坐标区工具栏添加用于打开和关闭坐标区网格线的自定义状态按钮。

首先，创建一个名为 mycustomstatebutton.m 的程序文件。在该程序文件中：

绘制随机数据图。
使用 axtoolbar 函数为坐标区创建一个工具栏，其中包含放大、缩小和还原视图的选项。
使用 axtoolbarbtn 函数向工具栏添加一个空状态按钮。返回 ToolbarStateButton 对象。
通过设置 Icon、Tooltip 和 ValueChangedFcn 属性，指定状态按钮的图标、工具提示和回调函数。此示例使用图标，此图标必须先作为图像文件保存到您的计算机路径中并命名为 mygridicon.png。

运行程序文件时，点击该图标即可打开和关闭网格线。

function mycustomstatebutton

plot(rand(5))
ax = gca;
tb = axtoolbar(ax,{'zoomin','zoomout','restoreview'});

btn = axtoolbarbtn(tb,'state');
btn.Icon = 'mygridicon.png';
btn.Tooltip = 'Grid Lines';
btn.ValueChangedFcn = @customcallback;

    function customcallback(src,event)
        switch src.Value
            case 'off'
                event.Axes.XGrid = 'off';
                event.Axes.YGrid = 'off';
                event.Axes.ZGrid = 'off';
            case 'on'
                event.Axes.XGrid = 'on';
                event.Axes.YGrid = 'on';
                event.Axes.ZGrid = 'on';
        end
    end

end

2-D plot with grid-state, zoom-in, zoom-out, and restore-view buttons in the axes toolbar

向工具栏添加普通按钮

为坐标区工具栏创建一个自定义普通按钮，用于创建坐标区视图的二维视图快照。

首先，创建一个名为 mycustompushbutton.m 的程序文件。在该程序文件中：

绘制一个曲面。
使用 axtoolbar 函数为坐标区创建一个工具栏，其中包含放大、缩小、旋转和还原视图的选项。
使用 axtoolbarbtn 函数向工具栏添加一个空普通按钮。返回 ToolbarPushButton 对象。
通过分别设置 Icon、Tooltip 和 ButtonPressedFcn 属性，指定普通按钮的图标、工具提示和回调函数。此示例使用图标，此图标必须先作为图像文件保存到您的计算机路径中并命名为 my2dicon.png。

运行程序文件时，点击该图标即可对坐标区的视图创建二维视图快照。

function mycustompushbutton

surf(peaks(25))
ax = gca;
tb = axtoolbar(ax,{'zoomin','zoomout','rotate','restoreview'});

btn = axtoolbarbtn(tb,'push');
btn.Icon = 'my2dicon.png';
btn.Tooltip = 'Snap to 2-D view';
btn.ButtonPushedFcn = @customcallback;

    function customcallback(src,event)
        view(event.Axes,2)
    end

end

2-D plot with custom 2-D icon, rotate, zoom-in, zoom-out, and restore-view buttons in the axes toolbar

输入参数

全部折叠

`tb` — 工具栏
`AxesToolbar` 对象

工具栏，指定为 AxesToolbar 对象。使用 axtoolbar 函数创建工具栏，例如 tb = axestoolbar。

`style` — 按钮样式
`'push'` | `'state'`

按钮样式，指定为下列选项之一。

样式	描述
`'push'`	普通按钮。点击一次，按钮将被按下并释放。
`'state'`	状态按钮有两种状态。点击一次，按钮将保持按下或释放状态，直到再次点击为止。

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数之后，但参数对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例： axtoolbarbtn(tb,'push','Icon','myimage.png','Tooltip','My Icon Tooltip')

注意

此处所列的属性只是一部分。普通按钮和状态按钮支持不同的属性集。有关每种类型的属性和描述的完整列表，请参阅相关联的属性页。

`Icon` — 按钮图标
`'none'` （默认） | 文件名 | m×n×3 数组 | m×n 矩阵 | 预定义图标

按钮图标，指定为下列值之一。坐标区工具栏将图标显示为灰度图像。MATLAB^® 将根据需要缩小图像以适应空间。

文件名 - 将文件名指定为字符向量或字符串标量。文件名前面可以有路径。图像文件必须为 JPEG、GIF 或 PNG 格式。
数组 - 指定表示图像中像素的由 RGB 三元组组成的 m×n×3 数组。
矩阵 - 指定表示图像中像素的 m×n 数值矩阵。
- 如果值是整数类型，则指定 0 和 63 之间的值。值 0 表示不透明，值 63 表示透明。NaN 也表示透明。
- 如果值的类型为 double，则指定 1 和 64 之间的值。值 1 表示不透明，值 64 表示透明。NaN 也表示透明。
预定义图标 - 指定下表中名称之一。

图标名称结果
'brush'
'datacursor'
'export'
'rotate'
'pan'
'zoomin'
'zoomout'
'restoreview'
'none' 没有图标