主要内容

直方图特性

直方图外观和行为

直方图属性控制直方图的外观和行为。通过更改属性值,可以修改直方图的各个方面。使用点表示法来引用特定的对象和属性:

h =直方图(randn (10,1));c = h.BinWidth;h.BinWidth = 2;

垃圾箱

全部展开

箱的数量,指定为正整数。如果没有指定NumBins,然后柱状图根据里面的值自动计算要使用多少个箱子数据

此选项不适用于分类数据的直方图。

存储箱的宽度,指定为标量。当您指定箱宽,然后柱状图可以使用最多65,536个垃圾桶(或216).如果指定的容器宽度需要更多的容器,则柱状图使用与最大箱数相对应的较大箱宽。

对于datetime和duration数据,的值“BinWidth”可以是标量持续时间或日历持续时间。

此选项不适用于分类数据的直方图。

例子:直方图(X,'BinWidth',5)使用宽度为5的垃圾箱。

容器的边,指定为数字向量。第一个vector元素指定了第一个箱子的左边缘。最后一个元素指定最后一个容器的右边缘。如果不指定箱边,则柱状图自动确定仓边的位置。

此选项不适用于分类数据的直方图。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

Bin极限,指定为二元向量,[bmin, bmax].该选项使用输入数组中的值绘制一个直方图,X介于两者之间bmin最大包容性。也就是说,X (X > = bmin & < = bmax)

此选项不适用于分类数据的直方图。

例子:直方图(X,'BinLimits',[1,10])仅使用中的值绘制直方图X介于110包容性。

仓限制的选择模式,指定为“汽车”“手册”.默认值为“汽车”,以便箱子限制自动根据数据进行调整。

如果您明确指定其中之一BinLimitsBinEdges,然后宾利米特斯莫自动设置为“手册”.在这种情况下,指定宾利米特斯莫作为“汽车”将容器限制重新缩放到数据。

此选项不适用于分类数据的直方图。

bining算法,指定为该表中的一个值。

价值

描述

“汽车”

默认值“汽车”算法选择一个仓宽来覆盖数据范围,并揭示底层分布的形状。

“斯科特”

如果数据接近正态分布,则Scott规则是最优的。此规则也适用于大多数其他发行版。它使用的箱子宽度为3.5 *性病(X(:)) *元素个数(X) ^ (1/3)

“fd”

Freedman-Diaconis规则对数据中的异常值不太敏感,可能更适合于具有重尾分布的数据2 *差(X(:)) *元素个数(X) ^ (1/3),在那里位差是的四分位范围X

“整数”

整数规则对于整数数据很有用,因为它为每个整数创建一个bin。它使用的仓宽为1,并将仓边放在整数中间。为了避免意外创建过多的容器,可以使用此规则创建65536个容器(216).如果数据范围大于65536,那么整数规则将使用更宽的容器。

请注意

“整数”不支持dateti金宝appme或duration数据。

“斯特格斯”

Sturges法则因其简单性而广受欢迎,它选择了要使用的垃圾箱的数量ceil(1+log2(numel(X)))

“√”

平方根规则在其他软件包中也被广泛使用。它选择箱子的数量装天花板(√元素个数(X)))

柱状图并不总是使用这些精确的公式来选择箱子的数量。有时会稍微调整桶的数量,使桶的边缘落在“好的”数字上。

对于datetime数据,bin方法可以是以下时间单位之一:

“第二” “月”
“一分钟” “四分之一”
“小时” “年”
“天” “十年”
“周” “世纪”

对于持续时间数据,bin方法可以是以下时间单位之一:

“第二” “天”
“一分钟” “年”
“小时”

如果您指定宾法使用datetime或duration数据,然后柱状图最多可使用65536个箱子(或2个16)。如果指定的存储箱持续时间需要更多存储箱,则柱状图使用与最大箱数相对应的较大箱宽。

此选项不适用于分类数据的直方图。

请注意

如果你设置BinLimitsNumBinsBinEdges,或箱宽财产,那么宾法属性设置为“手册”

例子:直方图(X,“BinMethod”、“整数”)创建一个柱状图,容器以整数为中心。

类别

全部展开

请注意

此选项仅适用于分类直方图。

直方图中包含的类别,指定为字符向量单元数组、类别数组或字符串数组。

  • 如果指定输入分类数组C,则默认情况下,柱状图中的每个类别绘制一个条形图C.在这种情况下,使用类别改为指定类别的唯一子集。

  • 如果指定bin计数,则类别指定直方图的关联类别名称。

例子:h =直方图(C,{“大”、“小”})仅绘制类别中的类别数据“大”“小”

例子:直方图(“类别”,{‘是的’,‘不’,‘也许’},“BinCounts”,[22 18 3])绘制一个柱状图,其中包含三个类别和相关的bin计数。

例子:h.Categories查询直方图对象中的类别h

数据类型:单间牢房|分类|字符串

类别显示顺序,指定为“提升”“下”,或“数据”. 具有“提升”“下”,直方图显示增加或减少条高。默认值“数据”值使用输入数据中的类别顺序,C

此选项仅适用于分类数据。

要显示的类别数目,指定为标量。属性可以更改柱状图中显示的类别的顺序“DisplayOrder”选择。

此选项仅适用于分类数据。

切换属于未显示类别的数据的摘要显示,指定为“上”“关闭”,或数字或逻辑1符合事实的)或0错误的).价值“上”相当于符合事实的“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

将此选项设置为“上”在柱状图中显示带有名称的附加条的步骤“别人”.这个额外的条数不属于直方图中显示的类别的所有元素。

属性可以更改柱状图中显示的类别数量以及它们的顺序“NumDisplayBins”“DisplayOrder”选项。

此选项仅适用于分类数据。

数据

全部展开

分布在容器中的数据,指定为向量、矩阵、多维数组或分类数组。如果数据不是向量吗柱状图把它看成一个单列向量,数据(:),绘制一个直方图。

柱状图漠视一切NaT,以及未定义的分类值。同样的,柱状图忽略了值,除非容器边明确指定作为仓边。虽然NaT<未定义>值通常不绘制,它们仍然包含在包括数据元素总数的标准化计算中,例如“概率”

只能为。指定分类值数据如果直方图对象最初是使用分类创建的。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑|分类|日期时间|持续时间

此属性是只读的。

Bin值,作为数字向量返回。如果规范化“伯爵”(默认值),然后是kth元素的元素个数数据落在第k个箱子间隔内(箱子计数)。最后一个存储箱包含打开的值要么Bin边缘,但所有其他容器只包括落在左边边缘的值。

取决于规范化,属性可以包含容器计数的规范化变体。

标准化类型,指定为此表中的一个值。对于每个箱子

  • v 是bin值。

  • c 是存储箱中的元素数。

  • w 是垃圾箱的宽度。

  • N 是输入数据中的元素数。如果数据包含,则此值可以大于装箱数据NaT,或<未定义>值,或者如果某些数据超出bin限制。

价值 本值 笔记
“伯爵”(默认)

v c

  • 计数或观察的频率。

  • 箱值之和小于或等于元素个数(X).总和小于元素个数(X)仅当一些输入数据没有包含在容器中时。

  • 对于分类数据,bin值之和小于或等于其中之一元素个数(X)总和(成员(X(:),类别))

“计数密度”

v c w

  • 计数或频率按料仓宽度缩放。

  • 每条条的面积(高*宽)是在箱子里观察到的数量。棒状区域的总和小于或等于元素个数(X)

  • 对于分类直方图,这与“伯爵”

请注意

“计数密度”不支持dateti金宝appme或duration数据。

“cumcount”

v j 1 c j

  • 累计计数。每个箱子的值是该箱子和之前所有箱子中观察到的累计数量。

  • 最后一栏的高度小于或等于元素个数(X)

  • 对于分类直方图,最后一根柱的高度小于或等于元素个数(X)总和(成员(X(:),类别))

“概率”

v c N

  • 相对概率。

  • 杆高之和小于或等于1

“pdf”

v c N w

  • 概率密度函数估计。

  • 每个条的面积是观察的相对数量。条面积之和小于或等于1

  • 对于分类直方图,这与“概率”

请注意

“pdf”不支持dateti金宝appme或duration数据。

“提供”

v j 1 c j N

  • 累积密度函数估计。

  • 每个条形的高度等于料箱和所有以前料箱中的累计相对观测数。最后一个条形的高度小于或等于1

  • 对于分类数据,每个条形图的高度等于每个类别和之前所有类别的观测值的累积相对数量。

例子:直方图(X,“正常化”,“pdf”)图的概率密度函数的估计X

仓位计数,指定为向量。使用此输入将仓位计数传递给柱状图单独执行仓位计数计算且您不希望柱状图进行任何数据装箱。

的长度计数必须等于箱子的数量。

  • 对于数值直方图,箱子的数量为长度(边缘)1

  • 对于分类直方图,箱子的数量等于类别的数量。

财产,宾克斯不是标准化的。如果规范化“伯爵”,然后宾克斯它们是等价的。

例子:直方图('BinEdges',-2:2,'BinCounts',[5 8 15 9])

例子:直方图(“类别”,{‘是的’,‘不’,‘也许’},“BinCounts”,[22 18 3])

容器计数的选择模式,指定为“汽车”“手册”.默认值为“汽车”,以便自动根据数据BinEdges

如果您指定宾克斯,然后BinCountsMode自动设置为“手册”.类似地,如果你指定数据,然后BinCountsMode自动设置为“汽车”

色彩与造型

全部展开

直方图显示样式,指定为“酒吧”“楼梯”.指定“楼梯”显示一个阶梯图,它显示直方图的轮廓而不填充内部。

的默认值“酒吧”显示直方图条形图。

例子:直方图(X、'DisplayStyle'、'stairs')绘制直方图的轮廓。

钢筋的方向,规定为:“垂直”“水平”

例子:直方图(X,“定位”,“水平”)创建具有水平条的直方图。

请注意

此选项仅适用于类别数据的直方图。

分类栏的相对宽度,指定为范围内的标量值[0,1]。使用此属性可以控制直方图中分类条的分隔。默认值为0.9,这意味着条形图的宽度是前一条条形图到下一条条形图空间的90%,两边各占5%。

如果将此属性设置为1,然后相邻的棒子互相接触。

例子:0.5

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

直方图的颜色,指定为以下值之一:

  • “没有”—酒吧没有被填满。

  • “汽车”—直方图的颜色是自动选择的(默认)。

  • RGB三元组、十六进制颜色代码或颜色名称-条形图用指定的颜色填充。

    RGB三元组和十六进制颜色代码用于指定自定义颜色。

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

    • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0F. 这些值不区分大小写。因此,颜色代码“#FF8800”“#ff8800”“#F80”“# f80”它们是等价的。

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

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

    样品的颜色为红色

    “绿色” ‘g’ (0 1 0) “# 00 ff00”

    样品的颜色为绿色

    “蓝” “b” (0 0 1) #0000FF"

    蓝色样品

    “青色” “c” (0 1 1) “# 00飞行符”

    样品的颜色为青色

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

    样品的颜色为洋红色

    “黄色” “y” (1 1 0) “# FFFF00”

    样品的颜色为黄色

    “黑” “k” (0 0 0) # 000000的

    黑色样品

    “白色” ' w ' (1 1 1) "FFFFFF"

    白色样品

    这里是RGB三联体和十六进制颜色代码的默认颜色MATLAB®用于许多类型的情节。

    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) "7E2F8E"

    样品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],呈暗红色

如果您指定DisplayStyle作为“楼梯”,然后柱状图不使用FaceColor财产。

例子:直方图(X,‘FaceColor’,‘g’)创建一个带有绿色条的直方图。

直方图边缘颜色,指定为以下值之一:

  • “没有”-不绘制边。

  • “汽车”-自动选择每条边的颜色。

  • RGB三元组、十六进制颜色代码或颜色名称-边缘使用指定的颜色。

    RGB三元组和十六进制颜色代码用于指定自定义颜色。

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

    • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0F. 这些值不区分大小写。因此,颜色代码“#FF8800”“#ff8800”“#F80”“# f80”它们是等价的。

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

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

    样品的颜色为红色

    “绿色” ‘g’ (0 1 0) “# 00 ff00”

    样品的颜色为绿色

    “蓝” “b” (0 0 1) #0000FF"

    蓝色样品

    “青色” “c” (0 1 1) “# 00飞行符”

    样品的颜色为青色

    “红色” “米” [1 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) "7E2F8E"

    样品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],呈暗红色

例子:直方图(X,‘EdgeColor’,‘r’)创建具有红色条边的直方图。

直方图条的透明度,指定为介于01包容性。柱状图对直方图的所有条使用相同的透明度。的值1意味着完全不透明0意思是完全透明(看不见)。

例子:直方图(X,'FaceAlpha',1)创建一个完全不透明的柱状图。

直方图条边缘的透明度,指定为之间的标量值01包容性。的值1意味着完全不透明0意思是完全透明(看不见)。

例子:直方图(X, EdgeAlpha, 0.5)创建具有半透明条形边的直方图。

行样式,指定为该表中列出的选项之一。

线条样式 描述 产生的线
“- - -” 实线

实线样本

“——” 虚线

虚线样本

':' 虚线

虚线样本

“-”。 Dash-dotted线

虚线的样本,带有交替的虚线和点

“没有” 没有线 没有线

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

例子:1.5

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

系列索引,指定为大于或等于的整数0.此属性用于重新分配多个面颜色柱状图对象,以便它们彼此匹配。默认情况下SeriesIndex财产的柱状图对象是与其创建顺序相对应的数字,从1

当您调用绘图函数时,MATLAB使用该数字计算分配颜色的索引。索引指存储在ColorOrder轴的性质。

MATLAB自动更新对象的面颜色柱状图当您更改对象的SeriesIndex或者当你改变的时候ColorOrder轴上的属性。但是,以下条件必须满足才能使更改生效:

  • FaceColor财产的柱状图对象设置为“汽车”

  • SeriesIndex财产的柱状图对象大于0

  • NextSeriesIndex属性的值大于0

传说

全部展开

图例使用的文本,指定为字符向量。文本出现在直方图的图标旁边。

例子:“文本描述”

对于多行文字,请使用创建字符向量sprintf用新的行字符\ n

例子:sprintf(1 \在线2行)

属性指定图例文本传奇函数。

  • 如果将文本指定为传奇函数,则图例使用指定的文本并设置DisplayName属性设置为相同的值。

  • 如果未将文本指定为传奇函数,则图例使用DisplayName财产。的默认值DisplayName是这些值之一。

    • 对于数字输入,DisplayName是一个字符向量,表示用于构造直方图的输入数据的变量名。如果输入数据没有变量名,则DisplayName是空的,,''

    • 对于分类数组输入,DisplayName是空的,,''

如果DisplayName属性不包含任何文本,则图例将生成一个字符向量“dataN”,在那里N是根据直方图对象在图例条目列表中的位置分配给直方图对象的编号。

如果以交互方式编辑现有图例中的字符向量,则MATLAB将更新DisplayName属性设置为编辑的字符向量。

此属性是只读的。

控件,用于从图例中包含或排除对象注释对象。设置底层图标显示样式属性设置为以下值之一:

  • “上”-将对象包括在图例中(默认)。

  • “关闭”-不要将对象包括在图例中。

例如,要排除一个图形对象,,从图例中设置图标显示样式财产“关闭”

go.Annotation.LegendInformation.IconDisplayStyle=“关闭”

控件来控制图例中的项目传奇函数。将第一个输入参数指定为要包含的图形对象的向量。如果您没有在第一个输入参数中指定现有的图形对象,则图例中将不会显示该图形对象。然而,图例创建后添加到轴上的图形对象确实会出现在图例中。考虑在创造所有情节后再创造传说,以避免额外道具。

互动性

全部展开

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

  • “上”-显示对象。

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

数据提示内容,指定为数据模板对象通过修改基础文档的属性,可以控制显示在数据提示中的内容数据模板对象。有关属性列表,请参见DataTipTemplate属性

有关修改数据提示的示例,请参见创建自定义数据提示

请注意

数据模板对象不返回芬多布吉findall,它不会被复制copyobj

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

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则不会显示关联菜单。

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

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

  • “关闭”-未选择。

选择句柄时的显示,指定为“上”“关闭”,或数字或逻辑1符合事实的)或0错误的).价值“上”等于true,那么“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”-当选择属性设置为“上”

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

回调

全部展开

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

  • 函数处理

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

  • 字符向量,这是一个有效的MATLAB命令或函数,在基本工作区中进行评估(不推荐)

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

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

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

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

请注意

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

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

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。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在执行处理回调队列的命令时确定回调中断行为。这些命令包括刷新屏幕数字uifiguregetframe等待暂停

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

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

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

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

请注意

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

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

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

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

请注意

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

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

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

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

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

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

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

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

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

  • “可见”-仅在可见时捕获鼠标单击可见属性必须设置为“上”.的HitTest属性决定柱状图对象响应单击或祖先响应。

  • “没有”-无法捕获鼠标点击。单击柱状图对象将单击传递给图形窗口当前视图中它后面的对象。的HitTest财产的柱状图对象没有效果。

对捕获的鼠标单击的响应,指定为“上”“关闭”,或数字或逻辑1符合事实的)或0错误的).价值“上”等于true,那么“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • “上”——触发ButtonDownFcn收回柱状图对象。如果你定义了快捷菜单属性,然后调用上下文菜单。

  • “关闭”对象的最近祖先触发回调柱状图对象,该对象包含以下内容之一:

    • HitTest属性设置为“上”

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

请注意

PickableParts属性决定柱状图对象可以捕获鼠标点击。如果不能,那么HitTest财产无效。

此属性是只读的。

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

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

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

父/子

全部展开

父级,指定为PolarAxes集团,或使改变对象。

孩子们,作为一个空的GraphicsPlaceholder数组或一个数据提示对象数组。使用此属性可查看绘制在图表上的数据提示列表。

不能使用添加或删除子项儿童财产。要将子列表添加到此列表,请设置财产的数据提示对象到图表对象。

对象句柄的可见性儿童属性,指定为以下值之一:

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

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

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

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

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

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为任意一种“直方图”“categoricalhistogram”.使用此属性可在绘图层次结构中查找给定类型的所有对象,例如使用芬多布吉

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

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

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

兼容性考虑

全部展开

不建议在R2020a开始

另请参阅

R2014b中引入