主要内容

传奇人物属性

传说外观和行为

传说控件的外观和行为传说对象。通过改变属性值,您可以修改图例的某些方面。使用点表示法来引用特定的对象和属性:

Plot (rand(3)) LGD = legend('a','b','c');c = lgd.TextColor;乐金显示器。TextColor = '红色';

位置及布局

全部展开

相对于坐标轴的位置,指定为本表中列出的位置值之一。

价值 描述
“北” 轴内侧顶部
“南” 轴内底
“东” 轴的右内
“西方” 轴左内侧
“东北” 轴的右上方(默认为2-D轴)
“西北” 在坐标轴的左上角
“东南” 在轴的右下方
“西南” 在轴的左下方
“northoutside” 坐标轴以上
“southoutside” 坐标轴以下
“eastoutside” 在坐标轴的右边
“westoutside” 在坐标轴的左边
“northeastoutside” 轴的右上角外侧(默认为3-D轴)
“northwestoutside” 坐标轴的左上角外面
“southeastoutside” 坐标轴的右下角外面
“southwestoutside” 坐标轴的左下角外面
“最佳” 与图中数据冲突最小的内轴
“bestoutside” 坐标轴的右上角外侧(当图例具有垂直方向时)或坐标轴下方(当图例具有水平方向时)
“布局” 平铺图表布局中的平铺。要将图例移动到不同的磁贴,请设置布局图例的属性。
“没有” 位置财产。使用位置属性指定自定义位置。

例子:传奇(“位置”,“northeastoutside”)

方向,指定为以下值之一:

  • “垂直”—垂直堆叠图例项。如果图例有多列,请沿着每列从上到下布局项目。

  • “水平”—并排列出图例项。如果图例有多列,则沿着每行从左到右布局项目。

例子:传奇(“取向”、“水平”)

列数,指定为正整数。如果没有足够的图例项来填充指定的列数,则显示的列数可能会更少。

使用取向属性控制图例项是按每列顺序显示,还是按每行顺序显示。

例子:乐金显示器。NumColumns = 3

的选择模式NumColumns值,指定为以下值之一:

  • “汽车”—自动选择。

  • “手动”—使用手动设置的值。要指定该值,请设置NumColumns财产。

自定义位置和大小,指定为窗体的四元素向量[左下宽高].前两个值,而且,指定从图形的左下角到图例的左下角的距离。最后两个值,宽度而且高度,指定图例尺寸。的单位属性决定位置单位。

如果您指定位置属性,然后MATLAB®自动更改位置财产“没有”

例子:legend({'A','B'},'Position',[0.2 0.6 0.1 0.2])

请注意

类的父容器时,设置此属性无效TiledChartLayout

定位单位,指定为此表中的值之一。

单位 描述
“归一化”(默认) 对容器进行规范化,通常是图中的容器。图的左下角映射到(0,0)右上角映射到(1,1).控件的值位置向量。
“英寸” 英寸。
“厘米” 厘米。
“角色”

基于系统默认字体的字符大小。

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

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

“点” 点。1分等于1/72英寸。
“像素”

像素。

从R2015b开始,以像素为单位的距离与Windows上的系统分辨率无关®而且麦金塔电脑系统。

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

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

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

所有单位都从容器窗口的左下角开始测量。

此属性影响位置财产。如果您更改了单位,那么在完成计算后将其返回到默认值是一个好做法,以防止影响其他假设的函数单位为默认值。

如果您指定位置而且单位属性是名称,值对创建对象时,那么规范的顺序很重要。如果你想用特定的单位定义位置,那么你必须设置单位属性位置财产。

布局选项,指定为TiledChartLayoutOptions对象。当图例处于平铺图表布局中时,此属性非常有用。

要在平铺图表布局的网格中定位图例,请设置瓷砖的属性TiledChartLayoutOptions对象。例如,考虑一个3 * 3平铺的图表布局。该布局在中心有一个瓷砖网格,沿外缘有四个瓷砖。实际上,网格是看不见的,外部的瓷砖不会占用空间,直到你用轴或其他对象填充它们。

3 × 3平铺图表布局图。

这段代码放置图例乐金显示器在网格的第三个瓦片..

lgd.Layout.Tile = 3;

要将图例放置在其中一个周围的磁贴中,请指定瓷砖财产“北”“南”“东”,或“西方”.例如,将值设置为“东”将图例放置在网格右侧的贴图中。

lgd.Layout.Tile =“东”

如果图例不是平铺图表布局的子图(例如,如果图例是图形的子图),则此属性为空且无效。

标签

全部展开

自动更新图例项,以反映轴的当前状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”-自动添加图例项目的新图形对象添加到轴。删除从坐标轴删除的图形对象的图例项。

  • “关闭”—不要自动添加图例项。

例子:传奇({“A”、“B”},“自动更新”,“关闭”)

图例标签的文本,指定为字符向量、字符串数组或分类数组的单元格数组。要在标签中包含特殊字符或希腊字母,请使用TeX标记。有关选项表,请参见翻译财产。

图例标题,作为图例文本对象返回。若要添加图例标题,请设置字符串属性的图例文本对象。若要更改标题外观,如字体样式或颜色,请设置图例文本属性。有关列表,请参见文本属性

情节(兰德(3));LGD =传说(1号线的“第2行”3号线的);lgd.Title.String =“我的传奇头衔”;lgd.Title.FontSize = 12;

或者,使用标题函数用于添加标题和控制外观。

情节(兰德(3));LGD =传说(1号线的“第2行”3号线的);标题(乐金显示器,“我的传奇头衔”“字形大小”, 12)

文本解释器,指定为以下值之一:

  • “泰克斯”-使用TeX标记的子集解释字符。

  • “乳胶”-使用LaTeX标记解释字符。

  • “没有”—显示文字字符。

特克斯标记

默认情况下,MATLAB支持TeX标记万博1manbetx的一个子集。使用TeX标记添加上标和下标,修改字体类型和颜色,并在文本中包含特殊字符。

修饰语一直有效到文本结束。上标和下标是个例外,因为它们只修改下一个字符或花括号内的字符。当您将解释器设置为“泰克斯”时,支持的修万博1manbetx饰符如下。

修饰符 描述 例子
^ {} 上标 “文本^{上标}’
_ {} 下标 “text_{下标}’
\男朋友 大胆的字体 “\ bf文本”
它\ 斜体字体 “\它文本”
\ sl 斜体(通常与斜体相同) “\ sl文本”
rm \ 正常的字体 “\ rm文本”
\字体名{说明符 字体名称-替换说明符使用字体族的名称。你可以和其他修饰语一起使用。 “\字体名{快递}文本”
\字形大小{说明符 字体大小-替换说明符以点单位为单位的数值标量值。 ”字形大小{15}文本”
{\颜色说明符 字体颜色-替换说明符用这些颜色中的一种:红色的绿色黄色的品红色的蓝色的黑色的白色灰色的暗绿色橙色,或lightBlue “{品红}\颜色文本”
\颜色(rgb){说明符} 自定义字体颜色-替换说明符三元素RGB三元组。 “\颜色(rgb){0, 0.5, 0.5}文本”

属性中支持的特殊字符万博1manbetx“泰克斯”翻译。

字符序列 象征 字符序列 象征 字符序列 象征

α

\ upsilon

υ

\ sim

\角

ϕ

\ leq

\ ast

\气

χ

\ infty

β\

β

ψ

\ clubsuit

γ

ω

\ diamondsuit

δ

Γ

\ heartsuit

ϵ

Δ

\ spadesuit

ζ

Θ

\ leftrightarrow

\埃塔

η

Λ

\ leftarrow

θ

Ξ

\ Leftarrow

\ vartheta

ϑ

Π

\向上光标键

\极微小

ι

Σ

\ rightarrow

\卡巴

κ

\ Upsilon

ϒ

\ Rightarrow

λ

Φ

\ downarrow

µ

Ψ

\保监会

º

ν

Ω

下午\

±

ξ

\原则

\组

π

\存在

\ propto

ρ

倪\

\部分

σ

丛\

\子弹

\ varsigma

ς

\约

\ div

÷

τ

\再保险

\ neq

\枚

\ oplus

\ aleph

、即时通讯

\杯

\ wp

\ otimes

\ subseteq

\帕

\帽

中\

\ supseteq

\ supset

\ lceil

\子集

int \

\ cdot

·

阿\

ο

\ rfloor

\底片

¬

\微分算符

\ lfloor

\ *

x

\ ldots

...

\补

\清音

\ '

´

\楔

\ varpi

ϖ

\ 0

\ rceil

\捕杀

中期\

|

\三角

\ langle

\版权

©

乳胶标记

要使用LaTeX标记,请将解释器设置为“乳胶”.对于内联模式,用单个美元符号包围标记().对于显示模式,用双元符号包围标记($ $).

乳胶模式 例子 结果
内联

'$\int_1^{20} x^2 dx$'

方程与LaTeX内联模式

显示

'$$\int_1^{20} x^2 dx$$'

方程与LaTeX显示模式

显示的文本使用默认的LaTeX字体样式。的字体名FontWeight,FontAngle属性没有影响。要更改字体样式,请使用LaTeX标记。

LaTeX解释器可以使用的文本的最大大小是1200个字符。对于多行文本,每行减少大约10个字符。

有关使用TeX和LaTeX的示例,请参见图表文本中的希腊字母与特殊字符.有关LaTeX系统的更多信息,请参见LaTeX项目网站https://www.latex-project.org/

字体

全部展开

字体名称,指定为受支持的字体名称或万博1manbetx“FixedWidth”.要正确显示和打印文本,必须选择系统支持的字体。万博1manbetx默认字体取决于您的操作系统和区域设置。

要使用固定宽度的字体,在任何地区都看起来不错,请使用“FixedWidth”.固定宽度的字体依赖于根FixedWidthFontName财产。设置根目录FixedWidthFontName属性导致立即更新显示以使用新字体。

字体大小,指定为大于零的标量值(单位为点)。默认字体大小取决于特定的操作系统和区域设置。

如果您更改轴字体大小,那么MATLAB自动将颜色条的字体大小设置为轴字体大小的90%。如果手动设置颜色条的字体大小,则更改轴字体大小不会影响颜色条字体。

字符厚度,指定为“正常”“大胆”

MATLAB使用FontWeight属性从系统上可用的字体中选择一种。并非所有字体都有粗体。因此,指定粗体字体粗细仍然可以得到正常字体粗细。

字符倾斜,指定为“正常”“斜体”

并非所有字体都有两种字体样式。因此,斜体可能看起来和正常字体一样。

颜色和样式

全部展开

文本颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或短名称。默认颜色为黑色,值为[0 0 0]

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

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

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

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

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

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

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

样品的颜色为蓝色

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

样品的颜色为青色

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

样品的颜色为洋红色

“黄色” “y” [11 10 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],呈暗红色

例子:[0 0 1]

例子:“蓝”

例子:“# 0000 ff”

背景颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或短名称。的默认值[1 1 1]对应白色。

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

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

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

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

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

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

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

样品的颜色为蓝色

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

样品的颜色为青色

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

样品的颜色为洋红色

“黄色” “y” [11 10 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],呈暗红色

例子:传奇({“A”、“B”},“颜色”,“y”)

例子:legend({'A','B'},'Color',[0.8 0.8 1])

例子:传奇({“A”、“B”},“颜色”,“# D9A2E9”)

框轮廓颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或短名称。的默认值[0.15 0.15 0.15]对应于深灰色。

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

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

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

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

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

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

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

样品的颜色为蓝色

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

样品的颜色为青色

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

样品的颜色为洋红色

“黄色” “y” [11 10 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],呈暗红色

例子:legend({'A','B'},'EdgeColor',[0 1 0])

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

  • “上”-在图例周围显示方框。

  • “关闭”—不要在图例周围显示方框。

例子:传奇({“A”、“B”},“盒子”,“关闭”)

框轮廓的宽度,指定为以点为单位的正值。1分等于1/72英寸。

例子:1.5

交互性

全部展开

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

  • “上”—显示对象。

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

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

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则上下文菜单不会出现。

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

  • “上”——选择。如果在绘图编辑模式下单击对象,则MATLAB将其设置为选择财产“上”.如果SelectionHighlight属性也设置为“上”,然后MATLAB显示对象周围的选择句柄。

  • “关闭”—未选中。

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

  • “上”-显示选择句柄选择属性设置为“上”

  • “关闭”-从不显示选择句柄,即使当选择属性设置为“上”

回调

全部展开

当您单击图例项时执行的回调,指定为以下值之一:

  • 函数处理。例如,@myCallback

  • 包含函数句柄和附加参数的单元格数组。例如,{@myCallback,长度}

  • 是有效的MATLAB命令或函数的字符向量,在基本工作空间中计算(不推荐)。

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

事件数据结构字段

描述
同行 与所单击的图例项关联的图表对象。
地区 单击图例项目的区域,返回为任意一个“图标”“标签”
SelectionType

单击类型,返回为以下值之一:

  • “正常”—一键鼠标左键

  • “扩展”- - - - - -转变+一键鼠标左键

  • “开放”-双击鼠标任意按钮

  • “alt”-单击鼠标右键,两个鼠标按钮(Windows和Mac),或鼠标中键(Mac和Linux)。如果快捷菜单属性包含有效的上下文菜单(这是默认值),则这种类型的单击将打开上下文菜单,而不是触发ItemHitFcn回调。

传说对象。
EventName 事件名称,“ItemHit”

请注意

如果你设置ButtonDownFcn属性,则ItemHitFcn属性已禁用。

例子

您可以创建交互式图例,以便在单击图例中的项目时,相关的图表以某种方式更新。例如,您可以切换图表的可见性或更改其线宽。设置ItemHitFcn属性设置为一个回调函数,该函数控制图表如何更改。此示例显示如何在单击图例中的图表图标或标签时切换图表的可见性。它创建一个回调函数来更改可见属性“上”“关闭”

将以下代码复制到一个新的函数文件中,并将其另存为hitcallback_ex1.m可以在当前文件夹中,也可以在MATLAB搜索路径的文件夹中。这两个输入参数,src而且evnt,分别是图例对象和事件数据结构。当您单击图例中的项目时,MATLAB自动将这些输入传递给回调函数。使用同行字段,以访问与所单击的图例项关联的图表对象的属性。

函数evnt hitcallback_ex1 (src)如果比较字符串(evnt.Peer.Visible“上”) evnt.Peer.Visible =“关闭”其他的evnt.Peer.Visible =“上”结束结束

然后绘制四行图,创建图例,并将图例对象分配给一个变量。设置ItemHitFcn属性设置为回调函数。单击图例中的项目可显示或隐藏相关图表。隐藏图表时,图例标签变为灰色。

情节(兰德(4));L =传说(1号线的“第2行”3号线的4号线的);l.ItemHitFcn = @hitcallback_ex1;

包含四项图例的线状图。光标指向第二项,其标签为灰色。相关的线从图中隐藏。

鼠标单击回调,指定为以下值之一:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 是有效的MATLAB命令或函数的字符向量,在基本工作空间中计算(不推荐)

使用此属性可在单击对象时执行代码。如果使用函数句柄指定此属性,则MATLAB在执行回调函数时将两个参数传递给回调函数:

  • 点击对象-从回调函数中访问点击对象的属性。

  • 事件数据-空参数。将其替换为波浪字符()在函数定义中,以指示不使用此参数。

有关如何使用函数句柄定义回调函数的详细信息,请参见回调函数定义

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则此回调不执行。

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

  • 函数处理。

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

  • 包含有效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调用回调时,该回调都会试图中断正在运行的回调。的可中断属性决定是否允许中断。的可中断属性有两个可能的值:

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

    • 如果正在运行的回调包含这些命令之一,那么MATLAB将在该点停止回调的执行并执行中断回调。当中断回调完成时,MATLAB恢复执行正在运行的回调。

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

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

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

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

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

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

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

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

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

捕捉鼠标点击的能力,指定为以下值之一:

  • “可见”-捕捉鼠标点击时可见。的可见属性必须设置为“上”并且你必须点击其中的一部分传说具有已定义颜色的对象。不能单击已将关联颜色属性设置为的部件“没有”.的HitTest属性确定是否传说对象对单击做出响应,或者如果一个祖先响应。

  • “没有”—无法捕获鼠标点击。单击传说对象在图形窗口的当前视图中将单击传递给它下面的对象。的HitTest的属性传说对象没有效果。

对捕获的鼠标单击的响应,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”-触发ButtonDownFcn的回调传说对象。如果你已经定义了快捷菜单属性,然后调用上下文菜单。

  • “关闭”类的最近祖先的回调传说对象,该对象具有以下类型之一:

    • HitTest属性设置为“上”

    • PickableParts属性设置为允许祖先捕获鼠标单击的值

请注意

PickableParts属性确定是否传说对象可以捕获鼠标单击。如果不能,那么HitTest财产没有影响。

此属性是只读的。

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

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

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

父/子

全部展开

父容器,指定为数字对象,面板对象,选项卡对象,或TiledChartLayout对象。

传说对象必须具有与关联轴相同的父对象。如果更改相关轴的父轴,则传说对象自动更新以使用相同的父对象。

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

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

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

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

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

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

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

标识符

全部展开

此属性是只读的。

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

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

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

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

版本历史

在R2014b中引入

全部展开

不建议从R2020a开始