本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

axtoolbarbtn

向坐标区工具栏添加按钮

说明

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

示例

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

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

示例

全部折叠

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

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

  • 绘制随机数据图。

  • 使用 axtoolbar 函数为坐标区创建一个工具栏,其中包含放大、缩小和还原视图的选项。

  • 使用 axtoolbarbtn 函数向工具栏添加一个空状态按钮。返回 ToolbarStateButton 对象。

  • 通过设置 IconTooltipValueChangedFcn 属性,指定状态按钮的图标、工具提示和回调函数。此示例使用 图标,此图标必须先作为图像文件保存到您的计算机路径中并命名为 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

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

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

  • 绘制一个曲面。

  • 使用 axtoolbar 函数为坐标区创建一个工具栏,其中包含放大、缩小、旋转和还原视图的选项。

  • 使用 axtoolbarbtn 函数向工具栏添加一个空普通按钮。返回 ToolbarPushButton 对象。

  • 通过分别设置 IconTooltipButtonPressedFcn 属性,指定普通按钮的图标、工具提示和回调函数。此示例使用 图标,此图标必须先作为图像文件保存到您的计算机路径中并命名为 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

输入参数

全部折叠

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

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

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

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

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

注意

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

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

  • 文件名 - 将文件名指定为字符向量或字符串标量。文件名前面可以有路径。图像文件必须为 JPEG、GIF 或 PNG 格式。

  • 数组 - 指定表示图像中像素的由 RGB 三元组组成的 m×n×3 数组。

  • 矩阵 - 指定表示图像中像素的 m×n 数值矩阵。

    • 如果值是整数类型,则指定 063 之间的值。值 0 表示不透明,值 63 表示透明。NaN 也表示透明。

    • 如果值的类型为 double,则指定 164 之间的值。值 1 表示不透明,值 64 表示透明。NaN 也表示透明。

  • 预定义图标 - 指定下表中名称之一。

    图标名称结果
    'brush'

    'datacursor'

    'export'

    'rotate'

    'pan'

    'zoomin'

    'zoomout'

    'restoreview'

    'none'没有图标

示例: btn.Icon = 'icon.png'

示例: btn.Icon = 'C:\Documents\icon.png'

示例: btn.Icon = 'rotate'

按钮工具提示,指定为字符向量、字符向量元胞数组或字符串数组。使用此属性可在指针悬停在按钮上时显示消息。要显示多行文本,请指定字符向量元胞数组或字符串数组。数组中的每个元素显示一行文本。

示例: btn.Tooltip = 'My Tooltip'

在 R2018b 中推出