Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

Histogram2 属性

二元直方图的外观和行为

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

h = histogram2(randn(10,1),randn(10,1));
c = h.NumBins;
h.NumBins = [4 7];

bin

全部展开

每个维度中的 bin 数,指定为由正整数组成的二元素向量 [nX nY]。如果不指定 NumBins,则 histogram2 自动基于 XY 中的值计算要使用多少个 bin。

示例: histogram2(X,Y,[10 20])

示例: h.NumBins = [10 20]

每个维度中的 bin 宽度,指定为二元素向量。向量中的第一个元素为 x 维度中的 bin 宽度,第二个元素为 y 维度中的 bin 宽度。

如果指定 BinWidth,则 histogram2 可以沿每个维度使用最多 1024 (210) 个 bin。如果指定的 bin 宽度需要多个 bin,则 histogram2 使用与最大 bin 数量对应的较大的 bin 宽度。

示例: histogram2(X,Y,'BinWidth',[5 10])x 维度使用的 bin 的大小为 5,在 y 维度使用的 bin 的大小为 10

x 维度中的 bin 边界,指定为向量。Xedges(1) 是 x 维度的第一个 bin 的第一个边界,Xedges(end) 是最后一个 bin 的外边界。

如果 Xedges(i)X(k) < Xedges(i+1) Yedges(j)Y(k) < Yedges(j+1),则 [X(k),Y(k)] 位于第 (i,j) 个 bin 中。每个维度中的最后 bin 还包含最后一个(外部)边界。例如,如果 Xedges(end-1)X(k)Xedges(end) Yedges(i)Y(k) < Yedges(i+1),则 [X(k),Y(k)] 属于最后一行中的第 i 个 bin。

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

y 维度中的 bin 边界,指定为向量。Yedges(1) 是 y 维度的第一个 bin 的第一个边界,Yedges(end) 是最后一个 bin 的外边界。

如果 Xedges(i)X(k) < Xedges(i+1) Yedges(j)Y(k) < Yedges(j+1),则 [X(k),Y(k)] 位于第 (i,j) 个 bin 中。每个维度中的最后 bin 还包含最后一个(外部)边界。例如,如果 Xedges(end-1)X(k)Xedges(end) Yedges(i)Y(k) < Yedges(i+1),则 [X(k),Y(k)] 属于最后一行中的第 i 个 bin。

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

x 维度的 bin 范围,指定为二元素向量 [xbmin,xbmax]。该向量表示 x 维度中的第一个和最后一个 bin 边界。

histogram2 只绘制在 bin 范围 Data(Data(:,1)>=xbmin & Data(:,1)<=xbmax)(包含这两个边界值)内的数据。

x 维度中 bin 范围的选择模式,指定为 'auto''manual'。默认值是 'auto',这样 bin 范围自动调整为沿 x 轴的数据。

如果显式指定 XBinLimitsXBinEdges,则 XBinLimitsMode 自动设置为 'manual'。在这种情况下,将 XBinLimitsMode 指定为 'auto' 可将 bin 范围重新调整为该数据。

y 维度的 bin 范围,指定为二元素向量 [ybmin,ybmax]。该向量表示 y 维度中的第一个和最后一个 bin 边界。

histogram2 只绘制在 bin 范围 Data(Data(:,2)>=ybmin & Data(:,2)<=ybmax)(包含这两个边界值)内的数据。

y 维度中 bin 范围的选择模式,指定为 'auto''manual'。默认值是 'auto',这样 bin 范围自动调整为沿 y 轴的数据。

如果显式指定 YBinLimitsYBinEdges,则 YBinLimitsMode 自动设置为 'manual'。在这种情况下,将 YBinLimitsMode 指定为 'auto' 可将 bin 范围重新调整为该数据。

分 bin 算法,指定为此表中的一个值。

说明
'auto'默认的 'auto' 算法选择一个 bin 宽度,以便涵盖数据范围并显示基础分布形状。
'scott'如果数据接近联合正态分布,则 Scott 规则最佳。该规则也适用于大多数的其他分布。它使用 bin 大小 [3.5*std(X(:))*numel(X)^(-1/4), 3.5*std(Y(:))*numel(Y)^(-1/4)]
'fd'Freedman-Diaconis 规则对数据中的离群值不太敏感,可能更适用于重尾分布的数据。它使用 bin 大小 [2*IQR(X(:))*numel(X)^(-1/4), 2*IQR(Y(:))*numel(Y)^(-1/4)],其中 IQR 为四分位差。
'integers'整数规则对整数数据有用,因为它为每个整数对组 XY 创建一个 bin。它对每个维度使用 bin 宽度 1 并将 bin 边界放在整数的中间。为避免无意间创建太多 bin,可以使用此规则创建 1024 (210) 个 bin 的限制。如果任一维度的数据范围大于 1024,则整数规则改用更宽的 bin。

注意

如果设置 NumBinsXBinEdgesYBinEdgesBinWidthXBinLimitsYBinLimits 属性,则 BinMethod 属性设置为 'manual'

示例: histogram2(X,Y,'BinMethod','integers') 创建一个具有以整数为中心的 bin 的二元直方图。

切换空 bin 的显示,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

示例: histogram2(X,Y,'ShowEmptyBins','on') 打开空 bin 的显示。

数据

全部展开

要分布到各 bin 中的数据,指定为 m×2 矩阵。histogram2XY 输入对应于 Data 中的列,即 Data(:,1)X(:)Data(:,2)Y(:)

histogram2 忽略所有的 NaN 值。同样,histogram2 忽略 Inf-Inf 值,除非 bin 边界将 Inf-Inf 显式指定为 bin 边界。虽然 NaNInf-Inf 值通常情况下不会绘制,但在包括所有数据元素的归一化计算(如 'probability')中,仍然会包含这些值。

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

此属性为只读

bin 值,以数值矩阵形式返回。如果 Normalization'count',则 Values 中的第 (i,j) 个条目指定 x 边界为 [Xedges(i), Xedges(i+1)] 且 y 边界为 [Yedges(j), Yedges(j+1)] 的 bin 的 bin 计数。

根据 Normalization 的值,Values 属性可以包含 bin 计数的某种归一化形式。

不同编号的 bin 在 Values 中的分布情况及其相对于 x 和 y 轴的方向如下图所示:

例如,bin (1,1) 包括位于每个维度中第一个边界上的值,右下角的最后一个 bin 包括位于其任何边界上的值。

归一化的类型,指定为下表中的值之一。

说明
'count'

默认的归一化方案。每个条形的高度是每个 bin 中累积的观测值数量。条形高度的总和等于 numel(X)numel(Y)

'probability'

每个条形的高度是相对观测值数量(bin 中的观测值数量/观测值总数量)。条形高度的总和是 1

'countdensity'

每个条形的高度是(bin 中的观测值数量/bin 面积)。每个条形的体积(高 * 面积)是 bin 中的观测值数量。条形体积的总和等于 numel(X)numel(Y)

'pdf'

概率密度函数的估计值。每个条形的高度是“bin 中的观测值数量/(观测值总数量 * bin 面积)”。每个条形的体积是相对观测值数量。条形体积的总和等于 1

'cumcount'

每个条形的高度是 x 和 y 维度的每个 bin 及以前的所有 bin 中的累积观测值数量。最后一个条形的高度等于 numel(X)numel(Y)

'cdf'

累积的密度函数估算值。每个条形的高度等于 x 和 y 维度的每个 bin 及以前的所有 bin 中的累积相对观测值数量。最后一个条形的高度是 1

示例: histogram2(X,Y,'Normalization','pdf') 绘制 XY 的概率密度函数估算值。

bin 计数,指定为矩阵。当单独执行 bin 计数计算且不希望 histogram2 执行任何数据分 bin 时,可使用此输入将 bin 计数传递给 histogram2

counts 必须是大小为 [nbinsX nbinsY] 的矩阵,从而为每个 bin 指定一个 bin 计数。

x 维度上的 bin 数量为 length(XBinEdges)-1,y 维度上的 bin 数量为 length(YBinEdges)-1

Values 属性相比,BinCounts 未进行归一化。如果 Normalization'count',则 Values 等同于 BinCounts

示例: histogram2('XBinEdges',-1:1,'YBinEdges',-2:2,'BinCounts',[1 2 3 4; 5 6 7 8])

bin 计数的选择模式,指定为 'auto''manual'。默认值为 'auto',即根据 DataXBinEdgesYBinEdges 自动计算 bin 计数。

如果您指定了 BinCounts,则 BinCountsMode 自动设置为 'manual'。同样,如果您指定了 Data,则 BinCountsMode 自动设置为 'auto'

颜色和样式

全部展开

直方图的显示样式,指定为 'bar3''tile'。指定 'tile' 以将直方图显示为矩形块阵列,这些图块用各种颜色指示 bin 值。

'bar3' 的默认值使用三维条形显示直方图。

示例: histogram2(X,Y,'DisplayStyle','tile') 将直方图绘制为矩形块阵列。

直方图的条形颜色,指定为下列值之一:

  • 'none' - 条形未填充。

  • 'flat' - 条形的颜色根据高度而有所不同。具有不同高度的条形有不同颜色。从图窗或坐标区颜色图中选择颜色。

  • 'auto' - 条形颜色是自动选择的(默认)。

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

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

    • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

    • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#FF8800''#ff8800''#F80''#f80' 是等效的。

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

    颜色名称短名称RGB 三元组十六进制颜色代码外观
    'red''r'[1 0 0]'#FF0000'

    'green''g'[0 1 0]'#00FF00'

    'blue''b'[0 0 1]'#0000FF'

    'cyan' 'c'[0 1 1]'#00FFFF'

    'magenta''m'[1 0 1]'#FF00FF'

    'yellow''y'[1 1 0]'#FFFF00'

    'black''k'[0 0 0]'#000000'

    'white''w'[1 1 1]'#FFFFFF'

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

    RGB 三元组十六进制颜色代码外观
    [0 0.4470 0.7410]'#0072BD'

    [0.8500 0.3250 0.0980]'#D95319'

    [0.9290 0.6940 0.1250]'#EDB120'

    [0.4940 0.1840 0.5560]'#7E2F8E'

    [0.4660 0.6740 0.1880]'#77AC30'

    [0.3010 0.7450 0.9330]'#4DBEEE'

    [0.6350 0.0780 0.1840]'#A2142F'

如果将 DisplayStyle 指定为 'stairs',则 histogram2 不使用 FaceColor 属性。

示例: histogram2(X,Y,'FaceColor','g') 创建一个带绿色条形的直方图。

直方图的边界颜色,指定为下列值之一:

  • 'none' - 不绘制边。

  • 'auto' - 每个边界的颜色都是自动选择的。

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

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

    • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

    • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#FF8800''#ff8800''#F80''#f80' 是等效的。

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

    颜色名称短名称RGB 三元组十六进制颜色代码外观
    'red''r'[1 0 0]'#FF0000'

    'green''g'[0 1 0]'#00FF00'

    'blue''b'[0 0 1]'#0000FF'

    'cyan' 'c'[0 1 1]'#00FFFF'

    'magenta''m'[1 0 1]'#FF00FF'

    'yellow''y'[1 1 0]'#FFFF00'

    'black''k'[0 0 0]'#000000'

    'white''w'[1 1 1]'#FFFFFF'

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

    RGB 三元组十六进制颜色代码外观
    [0 0.4470 0.7410]'#0072BD'

    [0.8500 0.3250 0.0980]'#D95319'

    [0.9290 0.6940 0.1250]'#EDB120'

    [0.4940 0.1840 0.5560]'#7E2F8E'

    [0.4660 0.6740 0.1880]'#77AC30'

    [0.3010 0.7450 0.9330]'#4DBEEE'

    [0.6350 0.0780 0.1840]'#A2142F'

示例: histogram2(X,Y,'EdgeColor','r') 创建一个带红色条形边界的直方图。

直方图条形的透明度,指定为介于 01(包括二者)之间的标量值。histogram2 对所有的直方图条形使用相同的透明度。值 1 表示完全不透明,0 则表示完全透明(不可见)。

示例: histogram2(X,Y,'FaceAlpha',0.5) 创建一个具有半透明条形的二元直方图。

直方图条形边的透明度,指定为介于 01(包含这两个边界值)之间的标量值。值 1 表示完全不透明,0 则表示完全透明(不可见)。

示例: histogram2(X,Y,'EdgeAlpha',0.5) 创建一个具有半透明条形边的二元直方图。

直方图条形上的光照效果,指定为下表中的值之一。

说明
'lit'

直方图条形显示伪光照效果,其中条形的侧边使用相对于顶部更暗的颜色。条形不受坐标区中其他光源的影响。

这是当 DisplayStyle'bar3' 时的默认值。

'flat'

直方图条形不会自动被照亮。若存在其他光源对象,则光照效果在条形面上是统一的。

'none'

直方图条形不会自动被照亮,且光源不影响直方图条形。

仅当 DisplayStyle'tile' 时,FaceLighting 才为 'none'

示例: histogram2(X,Y,'FaceLighting','none') 关闭直方图条形的光照。

线型,指定为下表中列出的选项之一。

线型说明表示的线条
'-'实线

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

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

示例: 1.5

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

序列索引,指定为大于或等于 0 的整数。此属性可用于重新分配几个 Histogram2 对象的面颜色,使它们相互匹配。默认情况下,Histogram2 对象的 SeriesIndex 属性是与其创建顺序对应的编号,从 1 开始。

在您调用绘图函数时,MATLAB 使用该编号计算用于分配颜色的索引。索引引用存储在坐标区的 ColorOrder 属性中的数组的行。

当您更改 Histogram2 对象的 SeriesIndex 或在坐标区上更改 ColorOrder 属性时,MATLAB 会自动更新该对象的面颜色。但是,要使更改生效,必须满足以下条件:

  • Histogram2 对象的 FaceColor 属性设置为 'auto'

  • Histogram2 对象的 SeriesIndex 属性大于 0

  • 坐标区对象的 NextSeriesIndex 属性大于 0

图例

全部展开

图例使用的文本,指定为字符向量。文本显示在 histogram2 的图标旁边。

示例: 'Text Description'

对于多行文本,请使用 sprintf 和换行符 \n 创建字符向量。

示例: sprintf('line one\nline two')

您也可以使用 legend 函数指定图例文本。

  • 如果您将该文本指定为 legend 函数的输入参数,则图例将使用该指定文本,同时将 DisplayName 属性设置为与之相同的值。

  • 如果未将该文本指定为 legend 函数的输入参数,则图例将使用 DisplayName 属性中的文本。默认情况下,DisplayName 是一个字符向量,代表用来构建直方图的 x 和 y 输入数据的变量名称。如果其中一个或全部两个输入都没有变量名称,则 DisplayName 为空,即 ''

如果 DisplayName 属性不包含任何文本,则该图例将生成一个字符向量。该字符向量的形式为 'dataN',其中 N 是基于 histogram2 对象在图例条目列表中的位置指定给它的编号。

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

此属性为只读

指定是否在图例中包含对象的控制项,返回 Annotation 对象。将基础 IconDisplayStyle 属性设置为以下值之一:

  • 'on' - 在图例中包含对象(默认值)。

  • 'off' - 不在图例中包含对象。

例如,要从图例中排除图形对象 go,请将 IconDisplayStyle 属性设置为 'off'

go.Annotation.LegendInformation.IconDisplayStyle = 'off';

您也可以使用 legend 函数控制图例中的项目。将第一个输入参数指定为要包含的图形对象的向量。如果未在第一个输入参数中指定现有图形对象,则该图形对象不会显示在图例中。但在创建图例后添加到坐标区的图形对象会显示在图例中。请考虑在创建所有绘图后创建图例以避免出现额外的项。

交互性

全部展开

可见性状态,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 显示对象。

  • 'off' - 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

数据提示内容,指定为 DataTipTemplate 对象。您可以通过修改底层 DataTipTemplate 对象的属性来控制数据提示中显示的内容。有关属性列表,请参阅 DataTipTemplate 属性

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

注意

findobjfindall 不返回 DataTipTemplate 对象,copyobj 也不复制该对象。

上下文菜单,指定为 ContextMenu 对象。使用此属性在您右键点击对象时显示上下文菜单。使用 uicontextmenu 函数创建上下文菜单。

注意

如果 PickableParts 属性设置为 'none' 或者 HitTest 属性设置为 'off',该上下文菜单将不显示。

选择状态,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true,'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 已选择。如果您在绘图编辑模式下点击对象,则 MATLAB 会将其 Selected 属性设置为 'on'。如果 SelectionHighlight 属性也设置为 'on',则 MATLAB 将在对象周围显示选择句柄。

  • 'off' - 未选择。

选择时显示选择句柄,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true,'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 在 Selected 属性设置为 'on' 时显示选择句柄。

  • 'off' - 永远不显示选择句柄,即使 Selected 属性设置为 'on' 也是如此。

回调

全部展开

鼠标点击回调,指定为下列值之一:

  • 函数句柄

  • 元胞数组,包含一个函数句柄和其他参数

  • 作为有效 MATLAB 命令或函数(在基础工作区中计算)的字符向量(不推荐)

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

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

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

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

注意

如果 PickableParts 属性设置为 'none' 或者 HitTest 属性设置为 'off',则不执行此回调。

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

  • 函数句柄。

  • 第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。

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

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

此属性指定要在 MATLAB 创建对象时执行的回调函数。MATLAB 将在执行 CreateFcn 回调之前初始化所有属性值。如果不指定 CreateFcn 属性,则 MATLAB 执行默认的创建函数。

对现有组件设置 CreateFcn 属性没有任何作用。

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

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

  • 函数句柄。

  • 第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。

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

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

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

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

回调执行控件

全部展开

回调中断,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

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

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

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

每当 MATLAB 调用回调时,回调都会试图中断正在运行的回调(如果存在)。运行中回调所属对象的 Interruptible 属性决定着是否允许中断。

  • 'on' 允许其他回调中断对象的回调。中断发生在 MATLAB 处理队列的下一个位置,例如当存在 drawnowfigureuifiguregetframewaitforpause 命令时。

    • 如果运行中回调包含以上命令之一,则 MATLAB 将在该时刻停止执行回调并执行中断回调。当中断回调完成时,MATLAB 将恢复执行运行中回调。

    • 如果运行中回调不包含以上命令之一,则 MATLAB 执行完当前回调,不会出现任何中断。

  • 'off' 阻止所有中断尝试。由中断回调所属的对象的 BusyAction 属性决定是放弃该中断回调还是将其放入队列中。

注意

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

  • 如果中断回调是 DeleteFcnCloseRequestFcnSizeChangedFcn 回调,则无论是否存在 Interruptible 属性值都会发生中断。

  • 如果运行中回调当前正在执行 waitfor 函数,则无论是否存在 Interruptible 属性值都会发生中断。

  • Timer 对象根据排定时间执行,而不管 Interruptible 属性值如何。

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

回调排队,指定为 'queue''cancel'BusyAction 属性决定 MATLAB 如何处理中断回调的执行。有以下两种回调状态要考虑:

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

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

无论何时 MATLAB 调用回调,该回调都会试图中断运行中回调。运行中回调所属对象的 Interruptible 属性决定着是否允许中断。如果不允许中断,则中断回调所属对象的属性 BusyAction 将决定是放弃该回调还是将回调放入队列中。以下是 BusyAction 属性的可能值:

  • 'queue' - 将中断回调放入队列中,以便在运行中回调执行完毕后进行处理。

  • 'cancel' - 不执行中断回调。

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

  • 'visible' - 仅当对象可见时才捕获鼠标点击。Visible 属性必须设置为 'on'HitTest 属性决定是 Histogram2 对象响应点击还是前代响应点击。

  • 'none' - 无法捕获鼠标点击。点击 Histogram2 对象会将点击操作传递给图窗窗口的当前视图中该对象下方的对象。Histogram2 对象的 HitTest 属性没有任何作用。

对捕获的鼠标点击的响应,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true,'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 触发 Histogram2 对象的 ButtonDownFcn 回调。如果您已定义 ContextMenu 属性,则调用上下文菜单。

  • 'off' - 触发满足以下条件之一的 Histogram2 对象的最近前代的回调:

    • HitTest 属性设置为 'on'

    • PickableParts 属性所设置的值允许前代捕获鼠标点击

注意

PickableParts 属性决定 Histogram2 对象是否可以捕获鼠标点击。如果无法捕获,则 HitTest 属性没有任何作用。

此属性为只读

删除状态,以 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值形式返回。

DeleteFcn 回调开始执行时,MATLAB 会将 BeingDeleted 属性设置为 'on'BeingDeleted 属性将一直保持 'on' 设置状态,直到组件对象不再存在为止。

在查询或修改对象之前,请先检查其 BeingDeleted 属性的值,以确认它不是待删除项。

父级/子级

全部展开

父级,指定为 AxesGroupTransform 对象。

子级,以空的 GraphicsPlaceholder 数组或 DataTip 对象数组形式返回。使用此属性来查看在图上绘制的数据提示的列表。

不能使用 Children 属性添加或删除子级。要向此列表中添加子级,请将 DataTip 对象的 Parent 属性设置为图对象。

父级的 Children 属性中对象句柄的可见性,指定为下列值之一:

  • 'on' - 对象句柄始终可见。

  • 'off' - 对象句柄始终不可见。该选项用于防止另一函数无意中对其进行更改。将 HandleVisibility 设置为 'off' 可在执行该函数时暂时隐藏句柄。

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

如果父级的 Children 属性中未列出该对象,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。此类函数的示例包括 getfindobjgcagcfgconewplotclaclfclose 函数。

隐藏的对象句柄仍有效。将根 ShowHiddenHandles 属性设置为 'on' 以列出所有对象句柄,而不管其 HandleVisibility 属性设置如何。

标识符

全部展开

此属性为只读

图形对象的类型,以 'histogram2' 形式返回。使用该属性在绘制层次结构中查找指定类型的所有对象,例如,使用 findobj 搜索该类型。

对象标识符,指定为字符向量或字符串标量。您可以指定唯一的 Tag 值作为对象的标识符。如果需要访问您代码中其他位置的对象,可以使用 findobj 函数基于 Tag 值搜索对象。

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

如果您在 App 设计工具中工作,请在该 App 中创建公共或私有属性以共享数据,而不是使用 UserData 属性。有关详细信息,请参阅在用 App 设计工具创建的 App 内共享数据

兼容性考虑

全部展开

从 R2020a 起不建议使用

另请参阅

在 R2015b 中推出