主要内容

ToolbarPushButton属性

轴工具栏按钮外观和行为

展开全部页面

ToolbarPushButton属性控制轴的外观和行为ToolbarPushButton对象。通过更改属性值，可以修改按钮的某些方面。

TB = axtoolbar('default') BTN = axtoolbarbtn(TB，'push') BTN。Tooltip = 'My Push Button';

按钮

全部展开

按钮图标，指定为这些值之一。坐标轴工具栏将图标显示为灰度图像。MATLAB®如果需要，将图像缩小以适应。

  • 文件名—将文件名指定为字符向量或字符串标量。文件名前可以加路径。图片文件支持JPEG、GIF或PNG格式。

  • Array -指定一个m-by-n- 3的RGB三元组数组，表示图像中的像素。

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

    • 如果值为整数类型，则指定介于之间的值0和63。值为0是不透明和值63是透明的。南也是透明的。

    • 如果值为类型双，然后指定之间的值1和64。值为1是不透明和值64是透明的。南也是透明的。

  • 预定义图标-在该表中指定一个名称。

    图标的名字 结果
    “刷”

    画笔图标
    “datacursor”

    Data-cursor图标
    “出口”

    导出图标
    “旋转”

    旋转图标
    “锅”

    盘图标
    “zoomin”

    的放大图标
    “zoomout”

    长镜头图标
    “restoreview”

    恢复视图图标
    “没有” 没有图标

例子:btn。图标= 'icon.png'

例子:btn。图标= 'C:\Documents\icon.png'

例子:btn。图标= 'rotate'

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

例子:btn。工具提示= '我的工具提示'

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

  • “上”—显示对象。

  • “关闭”—隐藏对象，但不删除对象。你仍然可以访问一个不可见对象的属性。

回调

全部展开

当你点击按钮时执行的按钮回调，指定为以下值之一:

  • 一个函数句柄。

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

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

如果使用函数句柄指定此属性，则MATLAB将传递源代码按钮对象和事件数据结构作为函数的第一个和第二个输入参数。该表描述了事件数据结构中的字段。

场 描述
源 按钮对象
轴 相关的轴对象
EventName “ButtonPushed”

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息，请参见为图形对象创建回调。

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

设置CreateFcn属性在现有组件上不起作用。

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

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息，请参见为图形对象创建回调。

此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前。如果没有指定DeleteFcn属性，然后MATLAB执行默认删除函数。

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

回调执行控制

全部展开

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

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

  • 的运行Callback是当前正在执行的Callback。

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

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

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

如果正在运行的回调包含这些命令之一，则可中断属性决定是否发生中断:

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

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

请注意

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

  • 如果中断回调是DeleteFcn，CloseRequestFcn,或SizeChangedFcn回调函数时，中断发生，而不管可中断属性值。

  • 方法当前正在执行等待函数，则中断发生而不管可中断属性值。

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

请注意

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

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

  • 的运行Callback是当前正在执行的Callback。

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

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

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

  • “队列”—将中断的回调放到队列中，待正在运行的回调执行完成后再处理。

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

此属性是只读的。

删除状态，作为类型的on/off逻辑值返回matlab.lang.OnOffSwitchState。

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

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

父/子

全部展开

父容器，指定为AxesToolbar对象。

该对象没有子对象。您不能设置此属性。

对象句柄的可见性孩子们属性，指定为以下值之一:

  • “上”-对象句柄始终可见。

  • “关闭”-对象句柄在任何时候都不可见。此选项用于防止另一个函数的意外更改。设置HandleVisibility来“关闭”在函数执行期间暂时隐藏句柄。

  • “回调”对象句柄在回调或回调调用的函数中可见，但在从命令行调用的函数中不可见。此选项阻止在命令行上访问对象，但允许回调函数访问它。

属性中未列出对象孩子们属性，则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数不能返回它。此类函数的示例包括得到，findobj，gca，gcf，gco，newplot，班，clf,关闭功能。

隐藏对象句柄仍然有效。设置根目录ShowHiddenHandles财产“上”列出所有对象句柄，而不管它们HandleVisibility属性设置。

标识符

全部展开

此属性是只读的。

图形对象的类型，返回为“toolbarpushbutton”。

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

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

如果您在应用程序设计器中工作，请在应用程序中创建公共或私有属性以共享数据，而不是使用用户数据财产。有关更多信息，请参见在应用设计器应用中共享数据。

未使用的属性

全部展开

设置此属性对该类型的对象没有影响。

鼠标单击回调，指定为函数句柄、单元格数组或字符向量。

请注意

按钮不使用此属性。

版本历史

在R2018b中引入

另请参阅

主题