主要内容

工具栏状态按钮属性

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

工具栏状态按钮属性控制轴的外观和行为工具栏状态按钮通过更改属性值,您可以修改状态按钮的某些方面。

tb=axtoolbar('default')btn=axtoolbarbtn(tb,'state')btn.Tooltip='My state Button';

按钮

全部展开

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

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

  • 数组-指定一个m × n × 3的RGB三联体数组,表示图像中的像素。

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

    • 如果值是整数类型,则指定介于两者之间的值063.的值0是不透明的还是价值的63是透明的。也是透明的。

    • 如果值的类型为,然后指定之间的值164.的值1是不透明的还是价值的64是透明的。也是透明的。

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

    图标的名字 后果
    “刷”

    “数据游标”

    “出口”

    “旋转”

    “潘”

    手形图标

    “zoomin”

    放大镜加号图标

    “zoomout”

    带有负号图标的放大镜

    “restoreview”

    房子图标

    “没有” 没有图标

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

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

例子:图标='旋转'

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

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

按钮的当前状态,指定为“上”“关闭”,或数字或逻辑1符合事实的)或0).价值“上”相当于符合事实的“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “上”—按下按钮。

  • “关闭”–按钮未按下。

可见性状态,指定为“上”“关闭”,或数字或逻辑1符合事实的)或0).价值“上”相当于符合事实的“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “上”-显示对象。

  • “关闭”-隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

回调

全部展开

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

  • 函数句柄。

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

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

当单击状态按钮时执行此回调。如果有状态按钮,则不执行价值通过编程方式属性更改。

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

描述
状态按钮对象
相关的对象
事件名 “ValueChanged”
价值 当前值(“上”“关闭”
PreviousValue 前一个值(“上”“关闭”

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调定义

此属性指定MATLAB创建对象时要执行的回调函数。MATLAB在执行CreateFcn回调。如果不指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设定CreateFcn现有组件上的属性无效。

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

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调定义

此属性指定当MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前回调。如果不指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

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

回调执行控制

全部展开

回调中断,指定为“上”“关闭”,或数字或逻辑1符合事实的)或0).价值“上”相当于符合事实的“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

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

  • 跑步callback是当前正在执行的回调。

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

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

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

如果正在运行的回调函数确实包含这些命令之一,则可中断拥有正在运行的回调的对象的属性决定中断是否发生:

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

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

请注意

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

  • 如果中断回调是DeleteFcnCloseRequestFcnSizeChangedFcn回调,则中断发生不管可中断属性值。

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

  • 如果中断回调属于计时器对象,则回调将根据计划执行,而与可中断属性值。

请注意

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

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

  • 跑步callback是当前正在执行的回调。

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

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

在这些条件下BusyAction拥有中断回调的对象的属性确定MATLAB如何处理中断回调BusyAction财产:

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

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

此属性是只读的。

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

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

检查BeingDeleted属性来验证对象在查询或修改之前不会被删除。

父母/子女

全部展开

父容器,指定为AxesToolbar对象

此对象没有子对象。无法设置此属性。

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

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

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

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

如果对象未在列表中列出孩子们属性,则通过搜索对象层次结构或查询句柄属性获得对象句柄的函数不能返回它。此类函数的示例包括得到芬多布吉gcagcfgconewplotclf关闭功能。

隐藏对象句柄仍然有效。请设置根显示隐藏句柄财产“上”列出所有对象句柄,而不管它们的可操作性属性设置。

标识符

全部展开

此属性是只读的。

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

对象标识符,指定为字符向量或字符串标量。你可以指定一个唯一的标签值用作对象的标识符。当您需要访问代码中其他位置的对象时,可以使用芬多布吉函数搜索对象标签价值

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

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

未使用的财产

全部展开

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

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

请注意

按钮不使用此属性。

介绍了R2018b