主要内容

PushTool属性

控制推工具的外观和行为

把工具按钮出现在图的顶部的工具栏。的uipushtool函数创建一个工具栏按钮,设置在显示之前所需的属性。通过改变属性值,您可以修改它的外观和行为的某些方面。使用点符号来引用一个特定的对象和属性。

pt = uipushtool;pt.Separator = '在';

把工具

全部展开

图标源或文件,指定为一个特征向量,字符串标量,或一个——- - - - - -n3真彩图像数组。如果您指定一个特征向量或字符串标量,它可以是一个在MATLAB图像文件的名字®路径或一个图像文件的完整路径。如果你打算与他人分享你的应用程序,将MATLAB的图像文件路径,以促进应用程序包装。金宝app支持图像格式包括JPEG、PNG、GIF和SVG。

如果你指定一个——- - - - - -n3数组,它是解释为真彩图像数组。关于真彩图像阵列的更多信息,请参阅图像类型

如果您所指定的图像大于16 x16像素,然后图标财产尺度图像,因此整个图像适合的工具。如果您所指定的图像小于16 x16像素,它不是扩大规模以适应可用空间。

图标属性只在应用程序设计师和金宝app支持uifigure的应用程序。如果图标CData属性都设置,那么CData属性将被忽略。

例子:“程序”MATLAB上指定一个图像文件路径。

例子:“C: \ \程序文件”指定一个图像文件的完整路径。

图像数组,指定为一个——- - - - - -n3真彩图像数组。数组中的值可以是:

  • 双精度值之间0.01.0

  • uint8之间的值0255年

防止图像出现剪或扭曲,指定数组n小于或等于16。如果图像是剪,那么只有中心16 x16使用数组的一部分。

请注意

为应用程序设计师和uifigure的应用程序,使用图标属性指定推和切换工具图标。

分隔线模式,指定为“关闭”“上”或数字或逻辑0()或1(真正的)。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

将这个属性设置为“上”划分的左边工具栏中的工具。

交互性

全部展开

可见性状态,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • “上”——显示对象。

  • “关闭”——隐藏对象没有删除它。你仍然可以访问一个看不见的UI组件的属性。

让你的应用程序启动更快,设置可见财产“关闭”对于所有UI组件,不需要在启动时出现。

操作状态,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,应用程序用户可以与组件交互。

  • 如果你设定这个属性“关闭”,组件似乎黯淡,表明应用程序用户不能与它交互,而且它不会触发一个回调。

工具提示,指定为一个特征向量,字符串标量,或分类数组。使用这个属性来显示一个消息当你悬停在组件中运行的应用程序。工具提示没有出现当组件是禁用的。如果指定这个属性作为分类数组,MATLAB使用数组中的值,而不是完整的类别。

在与创建数据uifigure函数,将工具和切换工具支持多行工具提示。金宝app创建一个多行提示,使用sprintf函数插入换行字符(' \ n ')在你的文本。例如:

txt = sprintf (“1号线\在线2”);

然后设置工具提示属性返回的值sprintf

在与创建数据函数,将工具和切换工具不支持多行工具提示。金宝app

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

工具提示,指定为一个特征向量,字符串标量,或分类数组。悬停在工具提示显示组件的应用程序。如果您指定这个属性作为分类数组,MATLAB使用数组中的值,而不是完整的类别。

请注意

TooltipString属性不推荐在R2018b开始。使用工具提示财产。

回调

全部展开

工具点击回调,指定这些值之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

关于指定回调函数作为函数的更多信息处理,细胞阵列,或字符向量,明白了指定一个回调函数

组件创建函数,指定这些值之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

更多信息关于指定一个回调函数处理属性值,单元阵列,或字符向量,不见了指定一个回调函数

这个属性指定一个回调函数执行时MATLAB创建组件。MATLAB之前执行初始化所有组件属性值CreateFcn回调。如果你不指定CreateFcn属性,然后MATLAB执行默认创建函数。

使用gcbo函数在你CreateFcn代码的组件被创建的对象。

设置CreateFcn属性在一个现有的组件对象没有影响。

组件删除函数,指定这些值之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

更多信息关于指定一个回调函数处理属性值,单元阵列,或字符向量,不见了指定一个回调函数

DeleteFcn属性指定一个回调函数执行时MATLAB删除组件(例如,当用户关闭窗口)。MATLAB执行DeleteFcn回调之前摧毁组件对象的属性。如果你不指定DeleteFcn属性,然后MATLAB默认执行删除功能。

使用gcbo函数在你DeleteFcn代码的组件对象删除。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

可中断属性决定了如果一个回调可以运行中断。有两种回调状态考虑:

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

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

每当MATLAB调用回调,回调试图中断正在运行的回调(如果存在的话)。的可中断对象的属性拥有运行调决定是否允许中断:

  • 的值“上”允许其他回调中断对象的回调。中断发生在接下来的MATLAB处理队列,比如有一个的时候drawnow,,getframe,等待,或暂停

    • 如果运行调包含其中的一个命令,然后用MATLAB停止执行回调并执行中断的回调。MATLAB简历执行运行时回调打断调完成。

    • 如果调不包含运行这些命令,然后用MATLAB完成执行回调没有中断。

  • 的值“关闭”块全部中断。的BusyAction属性的对象拥有打断调决定如果打断回调被丢弃或放到一个队列中。

请注意

回调中断和执行不同的行为在这些情况下:

  • 如果中断的回调DeleteFcn,CloseRequestFcn,或SizeChangedFcn回调,那么无论发生中断可中断属性值。

  • 如果运行目前执行的回调等待函数,那么无论发生中断可中断属性值。

  • 计时器根据时间表不管对象执行可中断属性值。

  • MATLAB不拯救属性或状态的显示,当一个中断发生。例如,返回的对象gcagcf执行命令时可能会改变另一个回调。

看到中断执行回调一个示例,展示了可中断BusyAction属性影响程序的行为。

回调排队指定为“队列”(默认)或“取消”。的BusyAction属性决定了MATLAB如何处理中断的执行回调。有两种回调状态考虑:

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

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

BusyAction财产的来源中断回调决定MATLAB如何处理其执行。的BusyAction财产这些值:

  • “队列”——把中断处理回调在一个队列跑回调结束后执行。

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

每当MATLAB调用回调,回调总是试图打断一个执行回调。的可中断对象的属性的回调是决定是否允许中断运行。如果可中断设置为:

  • ——中断发生在MATLAB处理队列。这是默认的。

  • - - -BusyAction打断回调对象的属性(拥有)决定如果MATLAB利用或忽略了打断回调。

看到中断执行回调一个示例,展示了BusyAction可中断属性影响程序的行为。

这个属性是只读的。

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

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted房地产仍将“上”直到组件对象已不复存在。

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

这个属性对某种类型的对象没有影响。

父/子

全部展开

父对象,指定为一个工具栏对象。使用这个属性来指定父工具栏创建工具或移动现有工具时不同的工具栏。

指定的对象处理,可见性“上”,“回调”,或“关闭”

这个属性控制对象的可见性在其父母的孩子。当一个对象不可见的父母的孩子,它不是由函数返回获取对象通过搜索对象层次结构或查询属性。这些功能包括得到,findobj,gca,gcf,gco,newplot,,clf,关闭。的HandleVisibility财产也控制对象的可见性的处理在父图的CurrentObject财产。对象是有效的,即使他们是不可见的。如果您可以访问一个对象,你可以设置它的属性,并将其传递给任何函数来操作对象。

HandleVisibility价值 描述
“上” 对象句柄总是可见的。
“回调” 从内部处理的对象是可见的回调函数或函数调用回调,但不是在从命令行调用的函数。这个选项块访问对象在命令行,但是允许回调函数来访问它。
“关闭” 对象句柄是无形的。这个选项是有用的防止意外更改UI被另一个函数。设置HandleVisibility“关闭”暂时隐藏处理在这个函数的执行。

标识符

全部展开

这个属性是只读的。

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

对象标识符指定为一个特征向量或字符串标量。您可以指定一个唯一的标签价值作为一个对象的标识符。当你需要访问对象在您的代码,您可以使用findobj基于函数搜索对象标签价值。

用户数据,指定为数组。指定用户数据可能是有用的在应用程序中共享数据。看到回调函数之间共享数据为更多的信息。

版本历史

之前介绍过的R2006a

全部展开