主要内容

表面性质

图表表面外观和行为

表面属性控制外观和行为表面对象。通过更改属性值,您可以修改Surface Chart的某些方面。使用点表示法查询和设置属性。

h =冲浪(…);c = h.CData;h.CDataMapping =“直接”;

脸上

全部展开

面部颜色,指定为此表中的值之一。

价值 描述
“平”

的值为每个面使用不同的颜色cdata.财产。首先,您必须指定cdata.属性作为矩阵相同的大小Zdata..每个面的第一个顶点的颜色值(正面)xy方向)决定了整个脸的颜色。时,不能使用此值FaceAlpha属性设置为'interp'

'interp'

基于值的值使用每个脸部的插值着色cdata.财产。首先,您必须指定cdata.属性作为矩阵相同的大小Zdata..通过在顶点处插入颜色值,颜色随着每个面而变化。时,不能使用此值FaceAlpha属性设置为“平”

RGB三元组,十六进制颜色代码,或颜色名称

为所有面使用指定的颜色。此选项不使用颜色值cdata.财产。

“texturemap” 转换颜色数据cdata.这样它符合表面。
“没有” 不要画脸。

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

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

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

或者,您可以按名称指定一些常见颜色。此表列出了名为Color选项,等效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”

(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] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

[0.6350 0.0780 0.1840] '#a2142f'

表面透明度,指定为以下值之一:

  • 标量在范围内[0,1]- 在所有面上使用均匀的透明度。的值1是完全不透明的0是完全透明的。价值01是半透明的。此选项不使用透明度值alphadata.财产。

  • “平”-使用不同的透明度为每个面基于值alphadata.财产。第一个顶点的透明度值决定了整个脸的透明度。首先,您必须指定alphadata.属性的大小相同的矩阵Zdata.财产。的FaceColor属性也必须设置为“平”

  • 'interp'-使用插值的透明度为每个面基于值alphadata.财产。通过插值顶点的值,每个面的透明度都有所不同。首先,您必须指定alphadata.属性的大小相同的矩阵Zdata.财产。的FaceColor属性也必须设置为'interp'

  • “texturemap”- 转换数据alphadata.这样它符合表面。

光对象在面上的效果,指定为以下值之一:

  • “平”-均匀地照射每一张脸。使用此值可查看分面对象。

  • “古尔戈”-不同的光在脸上。计算顶点的光线,然后线性插值光线穿过面的。使用这个值来查看曲面。

  • “没有”-不要将浅色物体的光线照射到脸部。

添加一个轻的物体到坐标轴,使用函数。

请注意

“冯氏”值已被删除。用“古尔戈”代替。

当顶点法线指向远离相机时的面部光照,指定为以下值之一:

  • 'reverselit'-照亮脸,就好像顶点法线指向相机。

  • 'unit'-不要照脸。

  • “点燃”-根据顶点法线照亮脸部。

使用此属性可区分对象的内部表面和外部表面。例如,请参见背面照明

边缘

全部展开

要显示的边,指定为'两个都'“行”,或“列”

边线颜色,指定为这里列出的值之一。的默认颜色(0 0 0)对应黑色边缘。

价值 描述
“没有” 不要画边缘。
“平”

的值为每条边使用不同的颜色cdata.财产。首先,您必须指定cdata.属性作为矩阵相同的大小Zdata..每个面的第一个顶点的颜色值(正面)xy方向)确定相邻边缘的颜色。时,不能使用此值EdgeAlpha属性设置为'interp'

'interp'

使用插值着色为每条边的基础上的值cdata.财产。首先,您必须指定cdata.属性作为矩阵相同的大小Zdata..通过线性插值顶点上的颜色值,每条边的颜色都有所不同。时,不能使用此值EdgeAlpha属性设置为“平”

RGB三元组,十六进制颜色代码,或颜色名称

对所有的边使用指定的颜色。此选项不使用颜色值cdata.财产。

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

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

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

或者,您可以按名称指定一些常见颜色。此表列出了名为Color选项,等效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”

(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] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

[0.6350 0.0780 0.1840] '#a2142f'

边缘透明度,指定为以下值之一:

  • 标量在范围内[0,1]- 使用所有边缘的均匀透明度。的值1是完全不透明的0是完全透明的。价值01是半透明的。此选项不使用透明度值alphadata.财产。

  • “平”-使用不同的透明度为每条边的基础上的值alphadata.财产。首先,您必须指定alphadata.属性的大小相同的矩阵Zdata.财产。第一个顶点处的透明度值确定整个边缘的透明度。的EdgeColor.属性也必须设置为“平”

  • 'interp'-使用插值透明度为每条边的基础上的值alphadata.财产。首先,您必须指定alphadata.属性的大小相同的矩阵Zdata.财产。通过插值顶点的值,每条边的透明度都有所不同。的EdgeColor.属性也必须设置为'interp'

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

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

“——” 虚线

':' 虚线

“-”。 Dash-dotted线

“没有” 没有线 没有线

线宽,在点中指定为正值,其中1点= 1/72英寸。如果线有标记,那么线的宽度也会影响标记的边缘。

线宽不能小于像素的宽度。如果将行宽设置为小于系统上一个像素的宽度的值,则该行将显示为一个像素宽。

尖锐的垂直和水平线条,指定为“上”“关闭”,或数字或逻辑1真的)或0错误的)。的值“上”等于true,那么“关闭”相当于错误的.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “上”-锐化垂直和水平线条,以消除不均匀的外观。

  • “关闭”- 不要锐化垂直或水平线。线路可能在厚度或颜色中显得不均匀。

如果关联的图形有GraphicsSmoothing物业设为“上”A.渲染器物业设为opengl的,然后图形对绘图应用平滑技术。在某些情况下,这种平滑技术可能会导致垂直和水平线在厚度或颜色上出现不均匀。使用AlignVertexCenters性质消除不均匀外观。

请注意

您必须有支持此功能的显卡。金宝app要查看是否支持该特性,请调用金宝apprenderiNfo.函数。如果支持,金宝apprenderiNfo.返回值1为了info.details.金宝appsupportsalignvertexcenters.

光物体在边缘上的效果,指定为以下值之一:

  • “平”-在每个边缘均匀地应用光。

  • “没有”-不要将光线物体的光线应用到边缘。

  • “古尔戈”- 计算顶点处的光,然后在边缘上线性内插。

请注意

“冯氏”值已被删除。用“古尔戈”代替。

标记

全部展开

标记符号,指定为此表中列出的值之一。默认情况下,对象不显示标记。指定标记符号在每个数据点或顶点处添加标记。

价值 描述
“o”
“+” 加号
‘*’ 星号
“。” 观点
“x” 交叉
“_” 水平线
'|' 垂直的线
“广场”“年代” 广场
“钻石”' d ' 钻石
“^” 向上指向三角形
“v” 向下的三角形
'>' 三点三角形
'<' 只左向三角形
五角星形的“p” 五角星(五角星)
'hexagram'“h” 六芒星(六)
“没有” 没有标记

标记的大小,指定为在点上的一个正值,其中1点= 1/72英寸。

标记轮廓颜色,指定为“汽车”“平”,RGB三联网,一个十六进制颜色代码,颜色名称或短名称。的“汽车”选项使用相同的颜色EdgeColor.财产。的“平”选择使用cdata.顶点的值以设置颜色。

有关自定义颜色,请指定RGB三态或十六进制颜色代码。

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

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

或者,您可以按名称指定一些常见颜色。此表列出了名为Color选项,等效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”

(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] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

[0.6350 0.0780 0.1840] '#a2142f'

标记填充颜色,指定为“汽车”“平”,RGB三联网,一个十六进制颜色代码,颜色名称或短名称。的“汽车”选项使用相同的颜色颜色属性为坐标轴。的“平”选择使用cdata.顶点的值设置颜色。

有关自定义颜色,请指定RGB三态或十六进制颜色代码。

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

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

或者,您可以按名称指定一些常见颜色。此表列出了名为Color选项,等效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”

(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] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

[0.6350 0.0780 0.1840] '#a2142f'

此属性仅影响圆形、正方形、菱形、五角形、六角形和四种三角形标记类型。

例子:(0.3 0.2 0.1)

例子:'绿色'

例子:'#d2f9a7'

坐标数据

全部展开

x指定为大小相同的矩阵的坐标数据Zdata.或者作为一个长度向量n,在那里[m,n] =大小(zdata)

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|约会时间|期间

选择模式xdata.,指定为以下值之一:

  • “汽车”—使用的列索引Zdata...

  • '手动的'—使用手动设置的值。要指定值,请使用绘图函数的输入参数或直接设置xdata.财产。

变量链接到xdata.,指定为包含MATLAB工作区变量名的字符向量或字符串。MATLAB在基本工作空间中计算变量以生成xdata.

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新xdata.价值观。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“x”

y-坐标数据,指定为大小相同的矩阵Zdata.或长度的矢量,在那里[m,n] =大小(zdata)

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|约会时间|期间

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

  • “汽车”—使用的行索引Zdata.

  • '手动的'—使用手动设置的值。要指定值,请使用绘图函数的输入参数或直接设置YData财产。

变量链接到YData,指定为包含MATLAB工作区变量名的字符向量或字符串。MATLAB在基本工作空间中计算变量以生成YData

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新YData价值观。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“y”

z-坐标数据,指定为矩阵。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|约会时间|期间

变量链接到Zdata.,指定为包含MATLAB工作区变量名的字符向量或字符串。MATLAB在基本工作空间中计算变量以生成Zdata.

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新Zdata.价值观。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:'Z'

颜色和透明度数据

全部展开

顶点颜色,以以下形式之一指定:

  • 2-D数组-使用颜色映射的颜色。通过设置为每个顶点指定颜色cdata.转换为大小相同的数组Zdata..的Cdatampapping.属性确定这些值如何映射到当前的Colormap中。如果是FaceColor属性设置为“texturemap”,然后cdata.不需要和?一样的尺寸Zdata..但是,它必须是类型uint8.的cdata.值映射以符合定义的表面Zdata.

  • 3-D阵列-使用真实的颜色。通过设置为每个顶点指定一个RGB三联体颜色cdata.到一个m × n × 3的数组[m,n] =大小(zdata).RGB三元组是一个由三个元素组成的向量,它指定颜色的红色、绿色和蓝色组件的强度。数组的第一页包含红色组件,第二页包含绿色组件,第三页包含颜色的蓝色组件。由于表面使用真实的颜色而不是彩色地图的颜色,Cdatampapping.财产无效。

    • 如果cdata.的类型是,则为RGB三联体值(0 0 0)对应于黑色和(1 1 1)对应于白色。

    • 如果cdata.是一个整数类型,那么表面使用全范围的数据来确定颜色。例如,如果cdata.的类型是uint8,然后(0 0 0)对应于黑色和(255 255 255)对应于白色。如果cdata.的类型是int8,然后[-128 -128 -128]对应于黑色和(127 127 127)对应于白色。

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

选择模式cdata.,指定为以下值之一:

  • “汽车”——使用Zdata.值来设置颜色。

  • '手动的'—使用手动设置的值。要指定值,请设置cdata.财产。

变量链接到cdata.,指定为包含MATLAB工作区变量名的字符向量或字符串。MATLAB在基本工作空间中计算变量以生成cdata.

默认情况下,没有链接变量,因此该值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新cdata.价值观。要强制更新值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,而不是呈现图形,直到您将所有数据源属性更改为适当的值。

彩色映射方法,指定为“缩放”'直接的'.使用此属性控制颜色数据值的映射cdata.colormap。

这些方法有以下效果:

  • '直接的'-将这些值解释为当前颜色图的索引。小数部分的值固定为最接近的下整数。

    • 如果值为类型,然后是值1或更少的映射到颜色映射中的第一种颜色。等于或大于颜色映射到颜色映射中的最后一种颜色的长度的值。

    • 如果值为类型uint8uint16uint32uint64int8int16int32,或int64,然后是值0或更少的映射到颜色映射中的第一种颜色。等于或大于colormap长度的值映射到colormap中的最后一种颜色(或达到类型的范围限制)。

    • 如果值为类型逻辑,然后是值0的值映射到颜色映射中的第一个颜色1映射到颜色映射中的第二种颜色。

  • “缩放”—将值缩放到最小和最大颜色限制之间。的这一属性包含颜色限制。

每个顶点的透明度数据,指定为阵列与尺寸相同Zdata.财产。指定值后,将FaceAlphaEdgeAlpha属性来控制透明类型。如果是FaceAlphaEdgeAlpha属性都设置为标量值,然后表面不使用alphadata.值。

alphadataMapping.属性决定曲面如何解释alphadata.属性值。

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

的解释alphadata.值,指定为以下值之一:

  • “没有”- 将值解释为透明度值。值1或更大是完全不透明的,值为0或更小是完全透明的,并且0和1之间的值是半透明的。

  • “缩放”-将值映射到图形的alphamap中。轴的最小和最大极限决定alphadata.分别映射到alphamap中的第一个和最后一个元素的值。例如,如果极限是[3 5],然后是值3.或less映射到alphamap中的第一个元素。的值5或更大的映射到alphamap中的最后一个元素。的阿利姆轴的属性包含极限。的alphamap.属性包含字母映射。

  • '直接的'-将值解释为图的alphamap中的索引。小数部分的值固定为最接近的下整数。

    • 如果值为类型,然后将1或更少的映射到alphamap中的第一个元素的值。值等于或大于alphamap映射的长度到alphamap中的最后一个元素。

    • 如果值是整数类型,则0或更小的值映射到alphamap中的第一个元素。等于或大于alphamap映射到alphamap中最后一个元素的长度的值(或整数类型的最大值)。整数类型包括uint8uint16uint32uint64int8int16int32, 和int64

    • 如果值为类型逻辑然后,0映射到ALPHAMAP中的第一个元素和1映射到ALPHAMAP中的第二元素的值。

法线

全部展开

每个表面顶点的正常向量,指定为m-by-by-3阵列,其中[m,n] =大小(zdata).为每个顶点指定一个法向量。

指定此属性的值将关联模式设置为手动模式。如果你没有指定法向量,那么表面将生成这些数据用于光照计算。

数据类型:|

选择模式顶点,指定为以下值之一:

  • “汽车”- 基于坐标数据计算普通向量。

  • '手动的'—使用手动设置的值。要指定值,请设置顶点财产。

每个表面面的正常载体,指定为(m-1) - (n-1)-by-3阵列,其中[m,n] =大小(zdata).每个面指定一个法向量。

指定此属性的值将关联模式设置为手动模式。如果你没有指定法向量,那么表面将生成这些数据用于光照计算。

数据类型:|

选择模式雕塑,指定为以下值之一:

  • “汽车”- 基于坐标数据计算普通向量。

  • '手动的'—使用手动设置的值。要指定值,请设置雕塑财产。

灯光

全部展开

环境光的强度,指定为范围内的标量值[0,1].环境光线是一种亮起整个场景的非向光线。轴上必须至少有一个可见光物体,用于可见环境光。

AmbientLightColor属性设置环境光的颜色。坐标轴上的所有对象的颜色都是相同的。

例子:0.5

数据类型:

漫射光强度,指定为范围内的标量值[0,1].漫反射是从轴中的光物体的非分隔反射率。

例子:0.3

数据类型:

镜面反射强度,指定为范围内的标量值[0,1].镜面反射是轴线上的光物体在表面上的亮点。

例子:0.3

数据类型:

镜面光斑的大小,指定为大于或等于1的标量值。大多数材料的指数都在这个范围内[5 20]

例子:7

数据类型:

镜面反射的颜色,指定为范围内的标量值[0,1].的值1只使用光源的颜色设置颜色。的值0使用反射物体的颜色和光源的颜色设置颜色。的颜色光的特性包含光源的颜色。比例随之线性而变化。

例子:0.5

数据类型:

传说

全部展开

图例标号,指定为字符向量或字符串标量。图例不会显示,直到你调用传奇命令。如果不指定文本,则传奇使用表单设置标签“dataN”

此属性是只读的。

控件,用于从图例中包含或排除对象注解对象。设置底层icondisplaystyle.属性设置为以下值之一:

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

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

例如,要排除一个图形对象,,来自图例集icondisplaystyle.财产“关闭”

go.annotation.legendinformation.icondisplaystyle =“关闭”

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

交互性

全部展开

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

  • “上”- 显示对象。

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

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

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

请注意

DataTipTemplate对象不返回findobj.findall,它不会被复制CopyObj.

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

请注意

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

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

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

  • “关闭”——而不是选择。

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

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

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

根据坐标轴限制裁剪对象,指定为“上”“关闭”,或数字或逻辑1真的)或0错误的)。的值“上”等于true,那么“关闭”相当于错误的.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • 的值“上”夹子部分在轴限制范围内的物体。

  • 的值“关闭”显示整个对象,即使它的部分出现在轴的限制之外。如果你创建一个plot, set,对象的部分可能会出现在坐标轴限制之外抓住,冻结轴缩放,然后创建对象,使其比原来的plot更大。

剪裁包含该对象的轴的属性必须设置为“上”.否则,此属性不起作用。有关剪切行为的更多信息,请参见剪裁轴的性质。

回调

全部展开

鼠标单击回调,指定为其中一个值:

  • 函数处理

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

  • 字符向量,这是一个有效的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调用回调时,该回调尝试中断正在运行的回调(如果存在的话)。的可中断拥有运行回调的对象的属性确定是否允许中断。

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

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

    • 如果运行回调不包含其中一个命令,则matlab完成在不中断的情况下执行回调。

  • 的值“关闭”阻止所有中断尝试。的BusyAction拥有中断回调的对象的属性确定中断呼叫是否被丢弃或放入队列中。

请注意

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

  • 如果中断回调为DeleteFcnCloseRequestFcnSizechangedFCN.回调,则中断发生不管可中断属性值。

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

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

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

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

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

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

每当MATLAB调用回调时,回调尝试中断运行的回调。的可中断属性决定是否允许中断。如果不允许中断,那么BusyAction拥有中断回调的对象的属性确定是否丢弃或放入队列中。这些是可能的值BusyAction财产:

  • “队列”- 将中断回调在运行回调完成后在队列中进行处理。

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

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

  • “可见”-捕捉鼠标点击时可见。的可见属性必须设置为“上”你必须点击其中的一部分表面具有已定义颜色的对象。不能单击将关联颜色属性设置为的部件“没有”.如果情节包含标记,那么如果边缘或填充具有定义的颜色,那么整个标记都是可点击的。的HitTest属性决定表面对象响应点击或祖先的响应。

  • '全部'-捕获鼠标点击不考虑能见度。的可见属性可以设置为“上”“关闭”你可以点击其中的一部分表面没有颜色的对象。的HitTest属性决定表面对象响应点击或祖先的响应。

  • “没有”-无法捕获鼠标点击。单击表面对象将单击次数传递给下面的对象,在图窗口的当前视图中。的HitTest财产无效。

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

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

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

    • HitTest物业设为“上”

    • PickableParts属性设置为一个值,该值使祖先捕获鼠标点击

请注意

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

此属性是只读的。

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

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

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

父/子

全部展开

父,指定为集团,或转变对象。

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

您无法使用或删除使用子项孩子们财产。要将子列表添加到此列表,请设置财产的数据对象到图表对象。

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

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

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

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

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

隐藏对象句柄仍然有效。设置根showhiddenhandles.财产“上”列出所有对象句柄,而不管它们的Huppervisibility.属性设置。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“表面”

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

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

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

兼容性考虑因素

全部展开

不建议在R2020a开始

在R2006A之前介绍