主要内容

图的属性

控制图形窗口的外观和行为

控件创建的图形或在GUIDE中使用的图形有效数字函数。创建的数字uifigure功能,请参阅UI图属性

图是图形或用户界面组件的容器。图属性控制图的特定实例的外观和行为。要修改图的各个方面,请更改属性值。使用点表示法来查询和设置属性。

F =图;u = f.单位;f.单位= '英寸';

窗口出现

全部展开

图菜单栏显示,指定为“图”“没有”.的菜单条属性使您能够显示或隐藏图形窗口顶部的默认菜单。指定“图”显示菜单栏。指定“没有”把它藏起来。

属性只影响默认菜单,不影响用uimenu命令。

菜单栏不会出现在WindowStyle属性设置为“模态”.如果将包含uimenu子元素的图形更改为“模态”时,菜单子元素仍然存在于孩子们属性。但是,菜单不显示WindowStyle设置为“模态”

请注意

如果不希望在图中显示默认菜单,则将此属性设置为“没有”当您创建图形时。

图工具栏显示,指定为以下之一:

  • “汽车”—与参数的值相同菜单条财产。

  • “图”-工具栏显示。

  • “没有”—工具栏不显示。

此属性只影响默认工具栏。它不影响其他工具栏,如相机工具栏或情节编辑工具栏。选择图工具栏从图中可以看出视图菜单将此属性设置为“图”

工具栏不会出现在WindowStyle属性设置为“模态”.如果包含工具栏的图被更改为“模态”的子工具栏中仍然存在孩子们属性。但是,工具栏不显示WindowStyle设置为“模态”

请注意

如果要隐藏默认工具栏,请将此属性设置为“没有”当您创建图形时。

交互式图形对接,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”-图可以在MATLAB中停靠®桌面。的桌面>码头图菜单项和Dock Figure按钮在菜单栏中启用。

  • “关闭”- MATLAB禁用桌面>码头图菜单项,不显示图形停靠按钮。

    您不能设置DockControls财产“关闭”如果WindowStyle设置为“停靠”

设置DockControls属性不支持MATLAB在线™

背景颜色,指定为RGB三元组、十六进制颜色编码、颜色名称或短名称。如果你指定“没有”时,背景色在屏幕上显示为黑色,但如果打印图形,则背景打印时仿佛图形窗口是透明的。

对于自定义颜色,请指定RGB三元组或十六进制颜色编码。

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1],例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()之后是三个或六个十六进制数字,取值范围从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” “g” [0 1 0] “# 00 ff00”

样品的颜色为绿色

“蓝色” “b” [0 0 1] “# 0000 ff”

蓝色的样品

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “m” [10 0 1] “#”就

洋红色的样品

“黄色” “y” [1 1 0] “# FFFF00”

样品的颜色为黄色

“黑色” “k” [0 0 0] “000000 #”

样品的颜色为黑色

“白色” “w” [1,1 1] “# FFFFFF”

样品的颜色为白色

“没有” 不适用 不适用 不适用 没有颜色

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三组和十六进制颜色代码。

RGB值 十六进制色码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体样本[0 0.4470 0.7410],显示为深蓝色

[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样本[0.8500 0.3250 0.0980],呈暗橙色

[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈暗黄色

[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样本[0.4940 0.1840 0.5560],呈深紫色

[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体样本[0.4660 0.6740 0.1880],呈现中绿色

[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样本[0.3010 0.7450 0.9330],显示为浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840],呈暗红色

数据类型:|字符

窗口样式,指定为以下之一:

  • “正常”—图形窗口独立于其他窗口,在显示图形时可访问其他窗口。

  • “模态”-图形显示在所有现有图形窗口的顶部,使它们无法访问,只要顶部的图形存在并保持模态。但是,在模态图之后创建的任何新图都将显示出来。

    当存在多个模态窗口时,最近创建的窗口将保持焦点并保持在所有其他窗口之上,直到它变得不可见,或返回正常的窗口样式,或被删除。这时,焦点会回到上一次有焦点的窗口。

  • “停靠”—图形显示在桌面或文档窗口。当WindowStyle属性设置为“停靠”,则不能设置DockControls财产“关闭”.的“停靠”选项不支持MATLAB在线

请注意

这些都是一些重要的特点WindowStyle属性和一些推荐的最佳实践:

  • 创建UI窗口时,总是指定WindowStyle财产。如果你还想设置调整位置,或OuterPosition属性的图形,然后设置WindowStyle财产。

  • 您可以更改WindowStyle属性在任何时候,包括当图形是可见的并且包含子图形时。然而,在某些系统上,设置此属性可能会导致图形闪烁或消失或重新出现,这取决于系统对正常窗口和模态窗口的实现。要获得最佳的视觉效果,请设置WindowStyle属性在创建时或在图形不可见时。

  • 调用重置对一个数字不改变的值WindowStyle财产。

模态窗口样式行为

WindowStyle设置为“模态”,图形窗口捕获所有MATLAB窗口上的所有键盘和鼠标操作,只要窗口是可见的。属于MATLAB以外应用程序的窗口不受影响。

打字Ctrl + C当模态图有焦点时,会使该图恢复到a“正常”WindowStyle属性设置。这允许用户在命令行上输入。

带有WindowStyle属性设置为“模态”可见属性设置为“关闭”直到MATLAB使它们可见,它们才表现为模态。因此,您可以隐藏一个模式窗口以便以后重用,而不是销毁它。

模态图不显示菜单子菜单、内置菜单或工具栏。但是,在模态图中创建菜单或更改WindowStyle属性设置为“模态”在一个与菜单孩子的数字。的菜单对象存在,而人物保留了它们。如果你重置数字WindowStyle财产“正常”,显示菜单。

窗口状态,指定为以下值之一:

  • “正常”—界面显示正常。

  • “最小化”-窗口被折叠,但你仍然可以执行命令来获取或设置它的属性,添加子窗口,或在窗口中创建图形。

  • “最大化”-窗口填满了屏幕。操作系统提供的最小化、还原和关闭按钮出现在窗口的角落。如果窗口的菜单和工具栏处于正常状态,则它们将以此状态显示。

  • “全屏”-窗口填满了屏幕。但是,操作系统提供的最小化、恢复和关闭按钮是隐藏的。如果窗口的菜单和工具栏处于正常状态,则它们将以此状态显示。

单击操作系统提供的“最小化”、“最大化”或“恢复”按钮将设置WindowState相应的属性。紧迫的Ctrl +季(Windows®和Linux®)或Ctrl + f +命令Mac OS)切换“全屏”状态。

设置WindowState停靠图形上的属性MATLAB在线不支持。

位置和尺寸

全部展开

可绘制区域的位置和大小,指定为窗体的矢量[左底宽高].此区域不包括图形边框、标题栏、菜单栏和工具栏。

的每个元素位置向量。

元素 描述
从主显示器的左边缘到窗口的内左边缘的距离。对于有多个监视器的系统,该值可能为负值。

如果图是停靠的,那么这个值相对于MATLAB桌面中的图面板。
从主显示器的底边到窗口的内底边的距离。对于有多个监视器的系统,该值可能为负值。

如果图是停靠的,那么这个值相对于MATLAB桌面中的图面板。
宽度 图的左右内边缘之间的距离。
高度 窗户内边缘的顶部和底部之间的距离。

所有的测量单位均由单位财产。

你不能指定这个数字位置属性在停靠图形时。

MATLAB在线,而且的要素位置向量被忽略。

要放置整个窗口,包括边框、标题栏、菜单栏、工具栏,请使用OuterPosition财产。

请注意

Windows操作系统强制执行一个最小窗口宽度和一个最大窗口大小。如果指定的图形大小超出了这些限制,则显示的图形将符合这些限制,而不是您指定的大小。

计量单位,指定为该表中的一个值。

单位价值 描述
“像素”(默认)

像素。

从R2015b开始,像素距离与Windows上的系统分辨率无关麦金塔电脑系统:

  • 在Windows系统中,一个像素是1/96英寸。

  • 麦金塔电脑在系统中,一个像素是一英寸的1/72。

在Linux系统上,像素的大小由系统分辨率决定。

“归一化” 这些单元是相对于父容器进行规范化的。容器的左下角映射到(0,0)右上角映射到(1,1)
“英寸” 英寸。
“厘米” 厘米。
“点” 点。1分等于1/72英寸。
“角色”

这些单元是基于图形根对象的默认uicontrol字体:

  • 字符宽度=字母的宽度x

  • 字符高度=两行文字的基线之间的距离。

要访问默认的uicontrol字体,请使用get(大的,“defaultuicontrolFontName”)集(大的,“defaultuicontrolFontName”)

MATLAB从父对象的左下角开始测量所有单位。

此属性影响位置财产。如果你改变单位属性时,请考虑在完成计算后将其值返回为默认值,以避免影响采用默认值的其他函数。

指定的顺序单位而且位置属性有以下影响:

  • 如果指定单位之前位置属性,然后MATLAB设置位置使用您指定的单位。

  • 如果指定单位之后的财产位置属性,MATLAB使用默认设置位置单位.然后,MATLAB将位置值设置为指定单元中的等价值。

可绘制区域的位置和大小,指定为窗体的矢量[左底宽高].此区域不包括图形边框、标题栏、菜单栏和工具栏。所有的测量单位均由单位财产。

属性值与位置属性值。

外部边界的位置和大小,指定为窗体的向量[左底宽高].此属性定义由图的外部边界(包括边界、标题栏、菜单栏和工具栏)包围的区域。

这个表描述了向量中的每个元素。

元素 描述
从主显示器的左边缘到图形窗口的左外边缘的距离。对于有多个监视器的系统,该值可能为负值。

如果图是停靠的,那么这个值相对于MATLAB桌面中的图面板。
从主显示器的底边到图形窗口的外部底边的距离。对于有多个监视器的系统,该值可能为负值。

如果图是停靠的,那么这个值相对于MATLAB桌面中的图面板。
宽度 图的左右外边缘之间的距离。
高度 图的顶部和底部外边缘之间的距离。

所有的测量单位均由单位财产。

你不能指定这个数字OuterPosition属性在停靠图形时。

请注意

Windows操作系统强制执行一个最小窗口宽度和一个最大窗口大小。如果指定的图形大小超出了这些限制,则显示的图形将符合这些限制,而不是您指定的大小。

此属性对数字没有影响。

可调整大小的数字,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

当此属性设置为“上”,这个数字是可调整的。否则,它就不能调整大小。

策划

全部展开

用于图形的轴内容的彩色地图,指定为——- - - - - -3.数组的RGB(红,绿,蓝)三元组定义个人色彩。

例子:figure('Colormap',[10 0 1;0 0 1;1 1 0])将颜色映射设置为三种颜色:品红、蓝色和黄色。

MATLAB通过行号访问这些颜色。

控件创建的对象的颜色映射会影响对象的呈现表面图像,补丁函数,但一般不影响其他图形对象。

当你设置Colormap属性,则图中的轴和图表使用相同的色彩图。

透明度地图内容,指定为有限alpha值的数组,从01.数组的大小可以是m × 1或1 × m。MATLAB通过数组中的索引访问alpha值。字母可以是任何长度。

方法创建的对象的呈现将受到alpha映射的影响表面图像,补丁函数,但不影响其他图形对象。

当你设置Alphamap属性,则图中的轴和图表使用相同的alpha映射。

指示如何添加下一个绘图,指定为“添加”“新”“替换”,或“replacechildren”

该表描述了每个值的效果。

属性值 效果
“新”

创建一个新图并将其用作当前图。

“添加”

添加新的图形对象而不清除或重置当前图形。

“replacechildren”

移除在添加新对象之前未隐藏的所有轴对象。不会重置图形属性。

相当于使用clf命令。

“替换”

在添加新的图形对象之前,删除所有轴对象并将图形属性重置为默认值。

相当于使用clf重置命令。

考虑使用newplot函数来处理NextPlot财产。有关更多信息,请参见坐标轴NextPlot财产和为图形准备图形和轴

用于屏幕显示和打印的Renderer,指定为以下值之一:

  • opengl的——OpenGL®渲染器。这个选项使MATLAB能够访问图形硬件,如果它在您的系统上可用的话。OpenGL渲染器按照从前到后的顺序显示对象,就像在监视器上看到的那样。当在显示器平面上的同一位置时,线总是画在面的前面。

  • “画家”-画家渲染器。这个选项适用于二维视图中的坐标轴。在2d中,画家渲染器按子顺序(指定顺序)对图形对象进行排序。在3-D中,画家渲染器按照从前到后的顺序对对象进行排序。但是,它可能不能正确地绘制3d中相交的多边形。

请注意

渲染器属性将在未来的版本中删除。有关更多信息,请参见版本历史

设置渲染器属性不支持MATLAB在线

OpenGL硬件和软件实现

OpenGL可以在所有运行MATLAB的计算机上使用,因为OpenGL的软件版本被内置到MATLAB中。然而,如果您的图形硬件支持硬件加速版本的OpenGL,那么MATLAB会自动使用硬件加速版本来提高性能。

在某些情况下,即使有硬件版本,MATLAB也会自动使用软件OpenGL。例如,如果MATLAB检测到有已知驱动程序问题的图形硬件,或者检测到您正在使用Windows上的虚拟机或远程桌面,则使用该软件版本。

如果MATLAB找不到可用的OpenGL库,就会发出警告。

软件OpenGL选择

要从硬件切换到软件OpenGL,请执行以下步骤:

  • 在Linux系统上,用这个命令启动MATLABmatlab -softwareopengl

  • 在Windows系统上,执行该命令opengl的软件或者用命令启动MATLABmatlab -softwareopengl

  • 在Macintosh系统上,软件OpenGL不受支持。

需要获取的软件版本如下:

  • 在Linux系统上,MATLAB使用了MATLAB发行版中包含的OpenGL软件实现。

  • 在Windows上,OpenGL作为操作系统的一部分可用。如果您遇到OpenGL的问题,请与您的图形驱动程序供应商联系,以获取最新的OpenGL合格版本。

  • 麦金塔电脑系统,软件OpenGL不可用。

确定OpenGL库版本

要确定MATLAB在您的系统上使用的OpenGL库的版本和供应商,请调用rendererinfo函数。例如,该命令获取当前轴的信息并将其存储在一个名为信息

Info = rendererinfo(gca)

控件中的图形渲染器的名称GraphicsRenderer字段。例如,如果MATLAB正在使用硬件加速OpenGL,则该字段返回“OpenGL硬件”.如果MATLAB使用的是OpenGL软件,则该字段返回“OpenGL软件”

XServer连接丢失

在使用Linux时,如果与XServer的连接中断,MATLAB可能会因分段违规而崩溃。如果出现这种情况,请确保系统安装了最新的XServer。

在Linux系统上,你也可以尝试升级OpenGL驱动程序,或者使用以下命令启动MATLAB软件OpenGL:

matlab-softwareopengl

渲染器选择,指定为:

  • “汽车”- MATLAB根据图中图形对象的大小和复杂性,选择打印和屏幕显示的渲染方法。

  • “手动”- MATLAB使用指定的渲染器渲染器财产。

MATLAB设置RendererMode财产“手动”如果显式设置渲染器财产“画家”opengl的

请注意

RendererMode属性将在未来的版本中删除。有关更多信息,请参见版本历史

轴图形平滑,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

平滑可以减少坐标轴图形中锯齿线的出现。MATLAB将平滑技术应用于坐标轴图形(以及坐标轴标尺)GraphicsSmoothing设置为“上”,且以下任何一个条件都成立:

  • 渲染器属性设置为“画家”

  • 渲染器属性设置为opengl的硬件卡支持OpenGL。

图像平滑 没有图形平滑

轴图形平滑。画出来的线看起来很平滑。

坐标轴没有平滑。画出来的线显得参差不齐。

(放大视图)

放大视图的轴图形与平滑。靠近图形边缘的像素逐渐从蓝色图形颜色过渡到白色背景颜色。


(放大视图)

放大视图的轴图形没有平滑。每个像素的颜色要么是蓝色图形色,要么是白色背景色,两者之间没有渐变。


如果坐标轴图形主要包含竖线或水平线,请考虑设置GraphicsSmoothing财产“上”这条线AlignVertexCenters财产“上”.平滑技术为平滑牺牲了一些锐度,这在这样的图形中可能特别明显。

请注意

图形平滑对文本没有影响。的值,MATLAB对文本进行平滑处理GraphicsSmoothing财产。

设置GraphicsSmoothing属性不支持MATLAB在线

印刷及出口

全部展开

打印或保存时,图形在页面上的大小和位置,指定为窗体的四元矢量[左底宽高]

  • 而且值—控制页面左下角到图左下角的距离。将图保存为非页面格式(如PNG或EPS格式)时,将忽略这些值。

  • 宽度而且高度值-控制图形大小。如果宽度和高度值太大,则图形可能达不到指定的大小。如果图没有达到特定的大小,则图上的任何UI组件(如UI控件或UI表)可能无法按预期保存或打印。

PaperUnits性质决定了计量单位的优劣PaperPosition值。考虑设置PaperUnits财产“归一化”.这个设置使MATLAB能够自动调整图形的大小,使其占据打印页面的相同相对数量,而不管页面大小。

例子:图(“PaperPosition”,[。25 .25 8 6])设置图形的大小和打印位置为(。25 .25 8 6]

指示在打印或保存时使用显示的图形大小,指定为两者之一“汽车”“手动”

  • “汽车”—打印或保存的图形大小与显示的图形大小一致。的宽度而且高度价值观PaperPosition属性等于显示上的图形大小。的而且数值在图的中间。如果显示的图形大小发生变化,则PaperPosition属性自动更新为适当的大小和位置值。

  • “手动”—打印或保存的图形大小可能与显示的图形大小不匹配。如果您想打印或保存与显示大小不同的图形,或者不希望图形位于打印或保存的页面的中心位置,请使用此选项。设置PaperPosition属性设置为所需的大小和位置。如果显示的图形大小发生变化,则PaperPosition属性不会自动更新。

若要生成与显示图形相同的输出大小和分辨率(DPI),请设置PaperPositionMode属性的“汽车”并保存图形使用打印r0选择。的r0选项确保输出分辨率与显示分辨率相同。如果分辨率不同,则生成的输出大小以测量单位(英寸、厘米、点)匹配显示的数字大小,但不以像素为单位。例如,如果显示分辨率是100 DPI,那么一个4 × 5英寸的图形是400 × 500像素。如果输出分辨率是200dpi,那么打印或保存的图形的尺寸是相同的英寸,但是是800 * 1000像素。

请注意

从R2016a开始,默认值为“汽车”.以前,默认值为“手动”

要更改默认值,请使用以下技术之一。

  • 设置打印首选项。打印首选项在MATLAB会话中持续存在。您可以将打印首选项设置为任意一种“汽车”“手动”,例如:

    matlab.graphics.internal.setPrintPreferences (“DefaultPaperPositionMode”“手动”)
    要查询当前打印首选项值,使用以下命令。如果设置了首选项,该命令将返回“汽车”“手动”.如果您没有设置首选项,该命令将返回“设置”
    matlab.graphics.internal.getPrintPreferences

  • 在根对象上设置默认值。此选项仅影响当前MATLAB会话中的新图,例如:

    集(大的,“defaultFigurePaperPositionMode”“手动”)

在打印图形或将其保存为分页格式(PDF和PostScript)时自定义页面大小®格式),指定为表单的双元素向量(宽高).在美国,默认值是8.5 [11].在欧洲和亚洲,默认值为29.7 [21]

请注意

如果要将图保存到文件中,则PaperSize属性只影响PDF和PostScript文件格式。其他文件格式忽略此属性。使用PaperPosition属性来控制已保存图形的大小。

PaperUnits属性决定了计量单位的PaperSize财产。您不能设置PaperSize属性,如果PaperUnits属性设置为“归一化”.尝试这样做会导致错误。

指定PaperSize属性设置PaperType属性设置为相应的类型(如果存在的话),或者设置为“自定义”否则。

用于的单位PaperSize而且PaperPosition,指定为以下值之一:

  • “英寸”-以英寸为单位。当语言环境为美国时,这是默认设置。

  • “归一化”-标准化单位。页面的左下角映射到(0,0)右上角映射到(1,1)

  • “厘米”-单位为厘米。当区域设置为Europe或Asia时,这是默认设置。

  • “点”-积分值。1分等于1/72英寸。

请注意

的值PaperUnits属性,最好是在完成计算后将属性返回到它的原始值,以免影响其他假定为PaperUnits属性没有改变。

打印图形或将其保存为分页格式(PDF和PostScript格式)时的页面方向,指定为以下值之一:

  • “画像”-垂直定位最长页面尺寸。

  • “景观”-水平定位最长页面尺寸。

看到东方函数获取更多信息。

请注意

当使用文件>另存为,只有PDF和全页PS格式使用PaperOrientation财产。其他格式忽略这些值。

打印图表或将其保存为分页格式(PDF和PostScript格式)时的标准页面大小,指定为该表中的值之一。指定PaperType属性设置PaperSize属性设置为相应的页面大小。

价值

页面大小(宽×高)

“usletter”

8.5 × 11英寸(美国默认)

“uslegal”

8.5 14

“小报”

11 x17在

“a0”

84.1 - 118.9厘米

“a1”

59.4 - 84.1厘米

“a2”

42 - - 59.4厘米

“a3”

29.7 - 42厘米

“a4”

21 × 29.7 cm(欧洲和亚洲默认)

的a5

14.8 - 21厘米

“b0”

102.9 - 145.6厘米

“b1

72.8 - 102.8厘米

“b2”

51.4 - 72.8厘米

“单位”

36.4 - 51.4厘米

“b4”

25.7 - 36.4厘米

“b5”

18.2 - 25.7厘米

“弓”

9乘12中

“arch-b”

12乘18在

“耳语”

18-by-24在

“arch-d”

24-by-36在

“arch-e”

36-by-48在

“一个”

8.5 11

“b”

11 x17在

“c”

17-by-22在

' d '

22-by-34在

“e”

34-by-43在

“自定义> <”

自定义页面大小。方法指定非标准页面大小PaperSize属性集PaperPosition到这个值。

图底色在保存或打印时指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”-更改图形背景和轴线背景颜色为白色。文本和图的其他方面也可能改变颜色,以改善生成输出的外观。

  • “关闭”—使用与显示器上相同的颜色。要更改显示上的图形背景颜色,请使用颜色属性。要更改轴的背景颜色,请使用颜色轴的性质。

鼠标指针

全部展开

指针符号,指定为下表中的值之一或“自定义”.符号的外观依赖于操作系统。

价值

结果符号(与系统相关)

“箭头”

箭头鼠标指针符号

“工字钢”

工字形鼠标指针符号

“十字”

十字线鼠标指针符号

“看”(繁忙的系统)

忙时系统鼠标指针符号

“topl”“botr”

指向左上角和右下角的双向箭头鼠标指针符号

“topr”“botl”

指向右上左下的双向箭头鼠标指针符号

“圆”

圆鼠标指针符号

“十字”

交叉鼠标指针符号

“芙蓉”

带有上、右、下、左四个箭头的鼠标指针符号

“左”“对”

指向左右的双向箭头鼠标指针符号

“高级”“底”

指向上下的双向箭头鼠标指针符号

“手”

手持鼠标指针符号

自定义指针符号

要创建自定义指针符号,请以编程方式设置指针财产“自定义”然后使用PointerShapeCData属性来定义符号。看到PointerShapeCData属性以获取更多信息。

限制

对象指定的指针符号指针属性不会在使用uihtml函数。

自定义指针符号,指定为16 × 16矩阵(用于16 × 16像素指针),或32 × 32矩阵(用于32 × 32像素指针)。设置时,图将使用此指针符号指针财产“自定义”

矩阵中的每个元素都定义了指针中1像素的亮度级别,其中元素可以有以下值之一:

  • 1-黑色像素。

  • 2-白色像素。

  • -透明像素,这样底层屏幕显示通过。

元素(1,1)对应于指针左上角的像素。

指针的活动像素,指定为双元素向量。对象中特定元素的行和列索引PointerShapeCData对应于所需活动像素的矩阵。的默认值。[1]对应于指针左上角的像素。

的范围之外指定的值PointerShapeCData矩阵,则指针使用的默认活动像素[1]代替。

此属性仅适用于指针属性设置为“自定义”

交互性

全部展开

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

  • “上”—显示对象。

  • “关闭”—隐藏对象,不删除对象。您仍然可以访问不可见UI组件的属性。

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

更改不可见容器的大小将触发SizeChangedFcn回调,当它变得可见。

改变了可见容器的属性的值可见子组件的属性。即使隐藏容器会导致隐藏子组件,情况也是如此。

当前图中的目标轴,指定为对象,PolarAxes对象,或图形对象,例如HeatmapChart

在所有存在子轴的图中,总有一个当前轴。当前轴不必是最上面的轴,设置一个轴为当前轴并不会将其重新堆叠到所有其他轴之上。如果一个图形不包含轴,则得到(gcf CurrentAxes)命令返回一个空数组。

查询CurrentAxes属性获取当前轴线对象,如果轴线不存在,则无需强制创建轴线。

当前对象,作为图的子对象返回。MATLAB设置CurrentObject属性设置为图中单击的最后一个对象。这个对象是视图中最前面的对象。

HitTest子对象的属性控制该对象是否可以成为CurrentObject

单击其对象HandleVisibility属性是“关闭”设置CurrentObject属性为空GraphicsPlaceholder数组中。为避免在用户单击隐藏对象时返回空数组,请设置HitTest属性的隐藏对象“关闭”

使用gco命令作为获取此属性值的替代方法。

当前点,作为双元素向量返回。这个向量包含(xy)鼠标指针的坐标,从图的左下角开始测量。属性指定的单位为值单位财产。

当您执行以下任何操作时,坐标会更新:

  • 在图中按下鼠标按钮。

  • 在图中按下鼠标按钮后释放它。

  • 在图中按下鼠标按钮,然后将其释放到图外。

  • 在图中旋转滚轮。

  • 在图中移动鼠标(不按任何按钮),前提是WindowButtonMotionFcn财产不是空的。

如果图形有响应鼠标交互的回调,并且您触发回调的速度比系统执行代码的速度快,那么坐标可能不能反映指针的实际位置。相反,它们是回调开始执行时的位置。

如果您使用CurrentPoint属性来绘制点,则坐标值可能包含舍入误差。

当前字符,作为最后按下的键的字符返回。当用户按下键时,图形具有焦点时,此属性会更新。

请注意

的行为选择属性在R2014b中发生了变化,不推荐使用。它不再对这种类型的对象有任何影响。这个属性可能会在未来的版本中被删除。

请注意

的使用SelectionHighlight属性不推荐。此属性对数字没有影响。这个属性可能会在未来的版本中被删除。

鼠标选择类型,返回为“正常”“扩展”“alt”,或“开放”.此属性提供有关图中发生的最后一次按下鼠标按钮的信息。

这个表列出了可能的情况SelectionType值和产生这些值的用户操作。

价值

相应的行动

“正常”

单击鼠标左键。

“扩展”

下列任何一项:

  • 转变-点击鼠标左键。

  • 单击鼠标中键。

  • 同时单击鼠标左右键。

“alt”

以下任何一种情况:

  • 控制-点击鼠标左键。

  • 单击鼠标右键。

“开放”

双击任意鼠标按钮。

上下文菜单,指定为快捷菜单对象创建的。uicontextmenu函数。使用此属性可在右键单击组件时显示上下文菜单。

常见的回调

全部展开

按下按钮回调,指定为以下值之一:

  • 函数句柄。

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

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

每当用户单击图的空白区域时,此回调就会执行。

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

使用SelectionType属性以确定用户是否按下了修饰符键。

组件创建函数,指定为以下值之一:

  • 函数句柄。

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

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

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

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

使用gcbo在你的CreateFcn获取正在创建的组件对象的代码。

设置CreateFcn属性对现有组件对象不起作用。

组件删除函数,指定为以下值之一:

  • 函数句柄。

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

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

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

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

使用gcbo在你的DeleteFcn获取正在删除的组件对象的代码。

键盘回调

全部展开

按键回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户在图形或子对象具有焦点时按下一个键时执行此回调函数。如果用户按下键UIControl表格组件时,回调函数不会执行,除非启用属性设置为“关闭”“不活跃”

如果用户几乎同时按下多个键,MATLAB就会检测到所有的键。

KeyPressFcn回调可以访问关于用户与键盘交互的特定信息。MATLAB将此信息传递到KeyData对象作为回调函数的第二个参数。该表列出了该对象的属性。

财产 描述

例子:

一个

转变

将一个

字符

按下一个或多个键后出现的字符。

方法按某些键或修改键Ctrl键可能在此属性中返回不可打印的字符。

单独按某些键(例如CtrlAlt转变)不会产生字符数据。

“一个” “=” “一个”
修饰符

包含按下的修饰符键的名称的单元格数组,例如“控制”“alt”,或“转变”.如果没有按下修饰符键,则单元格数组为空。

{1 x0细胞} {1 x0细胞} {“转变”} {“转变”}
关键

按下的键,由键上的小写标签标识(如“上页”),或一个描述性的词(如“空间”).

“一个” “平等” “转变” “一个”
当按下键时具有焦点的对象。 数字对象 数字对象 数字对象 数字对象
EventName 导致回调函数执行的操作。 键盘按键的 键盘按键的 键盘按键的 键盘按键的

KeyPressFcn在实时编辑器中不支持回调。

有关指定回调属性值和使用回调参数的详细信息,请参见指定回调函数

CurrentCharacter属性还返回字符信息。

键释放回调函数,指定为以下值之一

  • 函数句柄。

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

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

当用户在图形或子对象具有焦点时按下一个键时执行此回调函数。如果用户释放一个键UIControl表格组件时,回调函数不会执行,除非启用属性设置为“关闭”“不活跃”

KeyReleaseFcn回调可以访问关于用户与键盘交互的特定信息。MATLAB将此信息传递到KeyData对象作为回调函数的第二个参数。该表列出了该对象的属性。

财产 描述

例子:

一个

转变

将一个

字符

与释放的键相对应的字符。

方法按某些键或修改键Ctrl键可能在此属性中返回不可打印的字符。

单独按和释放某些键(例如CtrlAlt转变)不会产生字符数据。

“一个” “=” “一个”
修饰符

包含按下的修饰符键的名称的单元格数组,例如“控制”“alt”,或“转变”.如果没有释放任何修饰符键,则单元格数组为空。

{1 x0细胞} {1 x0细胞} {“转变”} {“转变”}
关键

释放的键,由键上的小写标签标识(如“上页”),或一个描述性的词(如“空间”).

“一个” “平等” “转变” “一个”
释放键时具有焦点的对象。 数字对象 数字对象 数字对象 数字对象
EventName 导致回调函数执行的操作。 “KeyRelease” “KeyRelease” “KeyRelease” “KeyRelease”

KeyReleaseFcn在实时编辑器中不支持回调。

有关指定回调属性值和使用回调参数的详细信息,请参见指定回调函数

窗口回调

全部展开

关闭请求回调,指定为以下值之一:

  • 函数句柄。

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

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

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

每当用户试图关闭图形窗口时,此回调就会执行。例如,您可以显示一个对话框,要求用户确认或取消关闭操作,或者阻止用户关闭包含UI的图。

其基本机制是:

  1. 用户发出关闭关闭所有命令,从计算机窗口管理器菜单关闭图形,或通过退出MATLAB关闭图形。

  2. close操作执行图中定义的函数CloseRequestFcn财产。默认值为“closereq”.的“closereq”操作无条件删除图,破坏窗口。

除非关闭请求函数调用删除关闭函数,MATLAB从不关闭图形。(你可以打电话删除(f)如果您创建了一个具有非破坏性关闭请求函数的窗口,则从命令行。)

代码示例:CloseRequestFcn显示对话框

这个例子展示了如何编写关闭请求函数的代码,以显示一个询问对话框,要求用户确认关闭操作。将代码保存到系统上的可写文件夹中。

函数my_closereq (src、事件)%关闭请求功能%,显示问题对话框选择= questdlg(“关闭这个图形?”...“关闭请求功能”...“是的”“不”“是的”);开关选择情况下“是的”删除(gcf)情况下“不”返回结束结束

现在,创建一个指定的图my_closereqCloseRequestFcn.注意,函数句柄没有显式地引用任何输入参数,但是函数声明包含两个输入参数。MATLAB在执行回调函数时自动传递这些参数。第一个参数是触发回调的UI组件,第二个参数为回调函数提供事件数据。

图(“CloseRequestFcn”@my_closereq)

关闭图窗口,弹出问题对话框。

Size changed回调,指定为以下值之一:

  • 函数句柄。

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

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

当容器的大小发生变化时(例如,当用户调整窗口的大小时),定义这个回调来定制应用程序的布局。

SizeChangedFcn当:

  • 这个容器第一次变得可见。

  • 这个容器在其大小改变时是可见的。

  • 这个容器在其大小改变后第一次变得可见。这种情况发生在容器不可见时大小发生变化,随后容器变为可见时。

定义a时需要考虑的其他要点SizeChangedFcn回调函数:

  • 考虑将此容器的显示延迟到所有变量之后SizeChangedFcn定义了用途。这种做法可以预防SizeChangedFcn返回错误的回调。若要延迟容器的显示,请设置其可见财产“关闭”.然后,设置可见财产“上”在你定义变量之后SizeChangedFcn回调使用。

  • 如果你的应用包含嵌套容器,它们会由内而外调整大小。

  • 控件中正在调整大小的容器SizeChangedFcn,引用源对象(回调中的第一个输入参数)或使用gcbo函数。

提示

作为一个简单的替代方法来指定SizeChangedFcn回调函数,你可以设置单位属性的所有对象“归一化”.这样做可以使这些组件按照容器的比例伸缩。

示例:编辑具有恒定高度的字段

使用SizeChangedFcn回调函数来限制UI组件的大小。例如,下面的代码创建了一个UI,该UI在窗口顶部有一个编辑字段。当用户调整窗口大小时,条形函数将其高度限制为20像素。该函数还将编辑字段的宽度设置为图形的宽度。使用点表示法设置和查询属性。

函数Myui f = figure(“可见”“关闭”“SizeChangedFcn”, @sbar);U = U = U“风格”“编辑”“标签”“状态栏”);f.Visible =“上”函数sbar(src,event) old_units = src. units;src。单位=“像素”;sbar_units = u.Units;u.Units =“像素”;fpos = src.位置;Upos = [1 fpos(4) - 20 fpos(3) 20];u.Position = upos;u.Units = sbar_units;src。Units = old_units;u.Visible =“上”结束结束

注意函数句柄for条形没有显式地引用任何输入参数,但函数声明包含两个输入参数。MATLAB在执行回调函数时自动传递这些参数。第一个参数是触发回调的UI组件,第二个参数为回调函数提供事件数据。

窗口下按按钮回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户单击图中的任何位置或其子对象之一时,执行此回调。如果用户单击aUIControl表格组件时,回调函数不会执行,除非启用属性设置为“关闭”“不活跃”

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

窗口按钮运动回调,指定为以下值之一:

  • 函数句柄。

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

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

通常,每当用户在图中移动指针时,此回调函数就会执行。但是,如果用户单击并按住鼠标按钮并将指针移动到图之外,则WindowButtonMotionFcn回调函数在指针在图之外时执行。

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

示例:Simple Drawing App

这个例子展示了如何创建一个使用WindowButtonMotionFcn回调。将以下代码复制并粘贴到编辑器中并运行它。然后用鼠标绘制一组连接的线段:

  • 单击并在坐标轴内拖动以绘制第一个线段。

  • 再次单击以定义线段的锚点。

  • 移动鼠标可添加另一条线段。

  • 右击可结束绘图模式。

函数drawing_app图(“WindowButtonDownFcn”,@wbdcb) ah =坐标轴(“SortMethod”“childorder”);轴([1 10 1 10])“点击并拖动”)函数wbdcb(src,event) seltype = src. selectiontype;如果比较字符串(seltype“正常”src。指针=“圆”;cp = ah.CurrentPoint;Xinit = cp(1,1);Yinit = cp(1,2);线(“XData”xinit,“YData”yinit,...“标记”“p”“颜色”“b”);src。WindowButtonMotionFcn = @wbmcb;src。WindowButtonUpFcn = @wbucb;结束函数wbmcb(src,event) cp = ah.CurrentPoint;Xdat = [xinit,cp(1,1)];Ydat = [yinit,cp(1,2)];霍奇金淋巴瘤。XData = xdat;霍奇金淋巴瘤。YData = ydat;drawnow结束函数wbucb(src,event) last_seltype = src. selectiontype;如果比较字符串(last_seltype“alt”src。指针=“箭头”;src。WindowButtonMotionFcn =;src。WindowButtonUpFcn =其他的返回结束结束结束结束

注意,回调函数句柄没有显式引用任何输入参数,但函数声明包含两个输入参数。MATLAB在执行回调时自动传递这些参数。第一个参数是触发回调的UI组件,第二个参数为回调函数提供事件数据。

窗口按钮回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户在图或其中一个子对象的任何位置释放鼠标按钮时,执行此回调。对象上的鼠标按钮松开UIControl表格组件时,回调函数不会执行,除非启用属性设置为“关闭”“不活跃”

图中按钮上的动作与按钮下的动作相关联。当按下按钮操作发生时,鼠标指针必须在图形内部,但当按上按钮操作发生时,鼠标指针可以在图形外部。

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

窗口按键回调,指定为以下值之一

  • 函数句柄。

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

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

当用户在图形或子对象具有焦点时按下一个键时执行此回调函数。

这个回调函数可以访问关于用户与键盘交互的特定信息。MATLAB将此信息传递到KeyData对象作为回调函数的第二个参数。该表列出了该对象的属性。

财产 描述

例子:

一个

转变

将一个

字符

按下一个或多个键后出现的字符。

方法按某些键或修改键Ctrl键可能在此属性中返回不可打印的字符。

单独按某些键(例如CtrlAlt转变)不会产生字符数据。

“一个” “=” “一个”
修饰符

包含按下的修饰符键的名称的单元格数组,例如“控制”“alt”,或“转变”.如果没有按下修饰符键,则单元格数组为空。

{1 x0细胞} {1 x0细胞} {“转变”} {“转变”}
关键

按下的键,由键上的小写标签标识(如“上页”),或一个描述性的词(如“空间”).

“一个” “平等” “转变” “一个”
当按下键时具有焦点的对象。 数字对象 数字对象 数字对象 数字对象
EventName 导致回调函数执行的操作。 “WindowKeyPress” “WindowKeyPress” “WindowKeyPress” “WindowKeyPress”

WindowKeyPressFcn在实时编辑器中不支持回调。

有关指定回调属性值和使用回调参数的详细信息,请参见指定回调函数

窗口键释放回调函数,指定为以下值之一

  • 函数句柄。

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

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

当用户在图形或子对象具有焦点时释放一个键时,此回调函数将执行。

这个回调函数可以访问关于用户与键盘交互的特定信息。MATLAB将此信息传递到KeyData对象作为回调函数的第二个参数。该表列出了该对象的属性。

财产 描述

例子:

一个

转变

将一个

字符

与释放的键相对应的字符。

方法按某些键或修改键Ctrl键可能在此属性中返回不可打印的字符。

单独按和释放某些键(例如CtrlAlt转变)不会产生字符数据。

“一个” “=” “一个”
修饰符

包含按下的修饰符键的名称的单元格数组,例如“控制”“alt”,或“转变”.如果没有释放任何修饰符键,则单元格数组为空。

{1 x0细胞} {1 x0细胞} {“转变”} {“转变”}
关键

释放的键,由键上的小写标签标识(如“上页”),或一个描述性的词(如“空间”).

“一个” “平等” “转变” “一个”
释放键时具有焦点的对象。 数字对象 数字对象 数字对象 数字对象
EventName 导致回调函数执行的操作。 “WindowKeyRelease” “WindowKeyRelease” “WindowKeyRelease” “WindowKeyRelease”

WindowKeyReleaseFcn在实时编辑器中不支持回调。

有关指定回调属性值和使用回调参数的详细信息,请参见指定回调函数

窗口滚动轮回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户移动滚动轮时,这个回调函数会执行,而图形或其子图形有焦点。但是,其他对象可能捕获滚动轮的移动并干扰此回调的执行。

执行此回调对CurrentObject而且SelectionType属性。

WindowScrollWheelFcn回调函数可以在用户旋转滚轮时访问特定的信息。MATLAB将此信息传递到ScrollWheelData对象作为回调函数的第二个参数。属性的属性ScrollWheelData对象。

财产

内容

VerticalScrollCount

一个正数或负数,表示滚动轮点击的方向和次数。向下滚动返回正的值。向上滚动返回一个负值。

垂直滚动计数是自上次执行回调以来发生的所有滚动轮单击的总和。通常情况下,该值为1-1.但是,滚动计数可以有更大的大小WindowScrollWheelFcn回调函数需要很长时间才能返回,或者如果用户快速旋转滚动轮。

VerticalScrollAmount

每次点击滚动轮所滚动的行数。通常情况下,该值为3.,但有些系统可能根据鼠标的配置方式返回不同的值。

对象,它执行回调。

EventName “WindowScrollWheel”

WindowScrollWheelFcn在实时编辑器中不支持回调。

有关指定回调属性值和使用回调参数的详细信息,请参见指定回调函数

例如:App for Changingx设在限制

这个例子展示了如何创建一个显示图形的应用程序。的限制x设在。将以下代码复制并粘贴到编辑器中并运行它。

函数scroll_wheel显示如何使用WindowScrollWheelFcn属性%F = figure(“WindowScrollWheelFcn”@figScroll,“名字”“滚轮演示”);X = [0:.1:40];Y = 4 *cos(x)./(x+2);A =坐标轴;H = plot(x,y);标题(“旋转滚轮”)函数figScroll (src、事件)如果事件。VerticalScrollCount > 0 xd = h.XData;Inc = xd(end)/20;X = [0:.1:xd(end)+inc];re_eval (x)elseif事件。VerticalScrollCount < 0 xd = h.XData;Inc = xd(end)/20;X = [0:.1:xd(end)-inc+.1];%不要让xd = 0;re_eval (x)结束结束函数Re_eval (x) y = 4.*cos(x)./(x+2);h.YData = y;h.XData = x;a.XLim = [0 x(end)];drawnow结束结束

注意函数句柄forfigScroll没有显式地引用任何输入参数,但函数声明包含两个输入参数。MATLAB在执行回调函数时自动传递这些参数。第一个参数是触发回调的UI组件,第二个参数为回调函数提供事件数据。

调整回调函数,指定为以下值之一:

  • 函数句柄。

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

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

ResizeFcn在实时编辑器中不支持回调。

请注意

的使用ResizeFcn属性不推荐。它可能会在未来的版本中被删除。使用SizeChangedFcn代替。

数据类型:function_handle|细胞|字符

回调执行控制

全部展开

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

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

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

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

每当MATLAB调用回调时,该回调将试图中断正在运行的回调(如果存在的话)。的可中断属性的值确定是否允许中断:

  • 的值“上”允许其他回调函数中断对象的回调函数。中断发生在MATLAB处理队列的下一个点,例如当有drawnow数字getframe等待,或暂停

    • 如果正在运行的回调包含这些命令中的一个,那么MATLAB将在此时停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB继续执行正在运行的回调。

    • 如果正在运行的回调不包含这些命令中的任何一个,那么MATLAB将不中断地完成回调的执行。

  • 的值“关闭”阻塞所有中断尝试。的BusyAction属性的属性确定中断回调是被丢弃还是放入队列中。

请注意

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

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

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

  • 计时器对象根据调度执行,而不考虑可中断属性值。

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

看到中断回调执行举个例子,说明如何可中断而且BusyAction属性影响程序的行为。

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

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

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

BusyAction中断回调源的属性决定了MATLAB如何处理它的执行。的BusyActionProperty有以下值:

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

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

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

  • -在MATLAB处理队列的下一个点发生中断。这是默认设置。

  • - - -BusyAction属性(属于拥有中断回调的对象)决定MATLAB是排队还是忽略中断回调。

看到中断回调执行举个例子,说明如何BusyAction而且可中断属性影响程序的行为。

成为当前对象的能力,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”—设置当前对象为数字当用户单击正在运行的应用程序中的组件时CurrentObject的属性数字gco函数返回数字作为当前对象。

  • “关闭”—当用户在运行的应用中单击图形时,当前对象不更新。

此属性是只读的。

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

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

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

父/子

全部展开

图parent,作为根对象返回。

儿童数字,返回为空GraphicsPlaceholder或一维对象数组。

方法无法添加或删除子节点孩子们财产。使用此属性可查看子列表或重新排列子列表。子元素的顺序反映了屏幕上组件的前后顺序(堆叠顺序)。MATLAB可能不允许你改变某些对象的顺序。例如,UIControl而且传说物体总是在前面对象。

若要向此列表添加子对象,请设置属性的子组件的数字对象。

具有HandleVisibility属性设置为“关闭”都没有列在孩子们财产。

图形对象的可见性,指定为“上”“回调”,或“关闭”

此属性确定一个图形是否在其父(根)的子列表中。HandleVisibility用于防止命令行用户无意中绘制或删除只包含用户界面组件(如对话框)的图。

如果一个对象不在其父对象的子列表中,则通过搜索对象层次结构或查询属性来查找对象的函数不能返回该对象。这些功能包括得到findobjgcagcfgconewplotclf,关闭

HandleVisibility属性值使用“回调”“关闭”设置后,该对象不会出现在父对象中孩子们属性,则图形不会出现在根目录中CurrentFigure属性,则对象不会出现在根目录中CallbackObject属性或图中CurrentObject属性,并且坐标轴不会出现在它们的父元素中CurrentAxes财产。

设置根目录ShowHiddenHandles财产“上”使所有对象可见,无论他们HandleVisibility设置(这不会影响HandleVisibility属性)。

标识符

全部展开

图形的名称,指定为字符向量或字符串标量。

例子:图(“名字”,“结果”)将图的名称设置为“结果”

缺省情况下,名称为的图n,在那里n为整数。当您指定的名字属性时,图的标题变为的图n的名字.如果你只想要的名字值显示,设置IntegerHandleNumberTitle“关闭”

此属性是只读的。

图的编号,作为整数或空数组返回。您可以使用此值引用一个数字。例如,图(2)使数字与数量物业价值2目前的数字。

如果IntegerHandle属性设置为“关闭”,数量财产是空的。

如果IntegerHandle“上”,数量属性为整数。当您删除该图时,MATLAB将重用该数字用于下一个图。

编号标题,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

当您将此属性设置为“上”图的标题中包含了这句话“图n”,在那里n是价值的数量财产。

这两个NumberTitle而且IntegerHandle必须设置为“上”显示显示标题中的数字。

使用整数句柄,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).的值“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

如果你设置IntegerHandle财产“上”, MATLAB会找到现有图形没有使用的最小整数值,并设置数量属性设置为该值。如果您删除一个图,MATLAB可以在一个新的图上重用它的编号。

如果你设置IntegerHandle财产“关闭”, MATLAB不为图分配一个整数值,它设置数量属性设置为空数组。

要在标题栏中显示图形编号,两者都可以IntegerHandle而且NumberTitle必须设置为“上”

用于保存图形的文件名,指定为字符向量或字符串标量。GUIDE使用这个属性来存储它所保存的UI布局文件的名称。

例子:图(“文件名”、“myfile.fig”)将文件名设置为myfile.fig

此属性是只读的。

图对象的类型,返回为“图”.使用此属性可在绘图层次结构中查找给定类型的所有对象。

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

用户数据,指定为任意数组。指定用户数据可以用于在应用程序内共享数据。看到在回调函数之间共享数据更多信息。

版本历史

R2006a之前介绍过

全部展开

Baidu
map