主要内容

ToolbarPushButton属性

轴工具栏按钮的外观和行为

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

TB = axtoolbar('default') BTN = axtoolbarbtn(TB,'push') BTN。工具提示= '我的按钮';

按钮

全部展开

按钮图标,指定为以下值之一。坐标轴工具栏以灰度图像的形式显示图标。MATLAB®如果需要,缩小图像以适合。

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

  • 数组——指定一个m × 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。Tooltip = 'My Tooltip'

可见状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值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).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

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

  • 运行回调是当前正在执行的回调。

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

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

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

如果正在运行的回调函数包含这些命令中的一个,则可中断属性的值确定中断是否发生:

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

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

请注意

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

  • 如果中断回调函数是DeleteFcnCloseRequestFcn,或SizeChangedFcn回调函数,则中断发生而不管可中断属性值。

  • 如果正在运行的回调函数当前正在执行等待函数,则中断发生而不管可中断属性值。

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

请注意

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

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

  • 运行回调是当前正在执行的回调。

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

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

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

  • “队列”—在正在运行的回调完成执行后,将中断回调放入队列中进行处理。

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

此属性是只读的。

删除状态,作为类型的开/关逻辑值返回matlab.lang.OnOffSwitchState

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

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

父/子

全部展开

父容器,指定为AxesToolbar对象。

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

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

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

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

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

中未列出的对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获得对象句柄的函数不能返回该属性。此类函数的示例包括得到findobjgcagcfgconewplotclf,关闭功能。

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

标识符

全部展开

此属性是只读的。

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

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

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

如果您正在使用App Designer,请在应用程序中创建公共或私有属性来共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用程序设计程序中共享数据

未使用的属性

全部展开

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

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

请注意

按钮不使用此属性。

版本历史

在R2018b中介绍

Baidu
map