主要内容

表面性质

原始的表面外观和行为

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

s =表面;c = s.CData;s.CDataMapping =“直接”;

全部展开

面颜色,指定为该表中的一个值。

价值 描述
“平”

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

的插值函数

使用插值着色为每个面孔的基础上的值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”是等价的。

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

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

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

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “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) “# 7 e2f8e”

(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属性也必须设置为“平”

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

  • “texturemap”—将数据转换为AlphaData使它与表面一致。

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

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

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

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

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

请注意

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

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

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

  • “灯”-不要照脸。

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

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

边缘

全部展开

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

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

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

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

的插值函数

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

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

对所有的边使用指定的颜色。属性中的颜色值不使用CData财产。

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) “# 0000 ff”

“青色” “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) “# 7 e2f8e”

(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属性也必须设置为“平”

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

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

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

“——” 虚线

“:” 虚线

“-”。 Dash-dotted线

“没有” 没有线 没有线

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

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

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

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

  • “关闭”-不要锐化垂直或水平线。这些线条可能在粗细或颜色上显得不均匀。

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

请注意

您必须有支持此功能的显卡。金宝app要查看是否支持该特性,请调用金宝apprendererinfo函数。如果它得到支持,金宝apprendererinfo返回值1info.Details.金宝appSupportsAlignVertexCenters

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

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

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

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

请注意

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

标记

全部展开

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

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

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

标记轮廓颜色,指定为“汽车”“平”、RGB三元组、十六进制颜色代码、颜色名称或短名称。的“汽车”选项使用相同的颜色EdgeColor财产。的“平”选择使用CData值来设置颜色。

对于自定义颜色,指定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) “# 0000 ff”

“青色” “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) “# 7 e2f8e”

(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”是等价的。

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

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

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

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “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) “# 7 e2f8e”

(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|分类|datetime|持续时间

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

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

  • “手动”—使用手动设置的值。要指定值,请将输入参数传递给绘图函数或直接设置XData财产。

y指定为大小相同的矩阵的坐标数据ZData或者向量长度(米),在那里[m, n] =大小(ZData)

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

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

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

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

z指定为矩阵的坐标数据。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

颜色和透明度数据

全部展开

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

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

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

    • 如果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财产。

直接或缩放的颜色映射,指定为以下值之一:

  • 按比例缩小的-转换颜色数据,以跨越部分颜色地图指示的轴这一属性,将数据值线性映射到颜色。看到caxis有关此映射的更多信息的参考页。

  • 直接-使用颜色数据作为索引直接进入颜色图。颜色数据应该是1到的整数值长度(colormap).MATLAB将小于1的值映射到colormap中的第一个颜色,以及大于1的值长度(colormap)到颜色图中的最后一种颜色。小数部分的值固定为最接近的下整数。

的大小相同的数组指定为每个顶点的透明度数据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中的索引。小数部分的值固定为最接近的下整数。

    • 如果值是type,则1或更小的值映射到alphamap中的第一个元素。等于或大于到alphamap中最后一个元素的alphamap映射长度的值。

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

    • 如果值是type逻辑,则值0映射到alphamap中的第一个元素,值1映射到alphamap中的第二个元素。

法线

全部展开

每个曲面顶点的法向量,指定为m × n × 3数组,其中[m, n] =大小(ZData).为每个顶点指定一个法向量。

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

数据类型:|

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

  • “汽车”—根据坐标数据计算法向量。

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

每个曲面的法向量,指定为(m-1)-by-(n-1)-by-3数组,其中[m, n] =大小(ZData).每个面指定一个法向量。

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

数据类型:|

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

  • “汽车”—根据坐标数据计算法向量。

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

照明

全部展开

环境光强度,指定为范围内的标量值[0, 1].环境光是照亮整个场景的无方向性光。在坐标轴上必须至少有一个可见光物体,以使环境光可见。

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

例子:0.5

数据类型:

漫射光强度,指定为范围内的标量值[0, 1].漫反射光是来自轴中的光物体的非镜面反射。

例子:0.3

数据类型:

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

例子:0.3

数据类型:

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

例子:7

数据类型:

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

例子:0.5

数据类型:

传说

全部展开

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

此属性是只读的。

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

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

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

例如,要排除一个图形对象,,从传说集IconDisplayStyle财产“关闭”

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

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

交互性

全部展开

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

  • “上”—显示对象。

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

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

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

此属性仅适用于具有固定数据提示的曲面。

请注意

DataTipTemplate对象不返回findobjfindall,它不会被复制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处理队列的下一个点,例如当有drawnow数字uifiguregetframe等待,或暂停命令。

    • 如果正在运行的回调函数包含其中一个命令,那么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属性来验证对象在查询或修改之前不会被删除。

父/子

全部展开

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

儿女,归为空GraphicsPlaceholder数组或一个DataTip对象数组。使用此属性可查看绘制在图表上的数据提示列表。

属性添加或删除子节点孩子们财产。要将子列表添加到此列表,请设置财产的DataTip对象指向图表对象。

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

  • “上”-对象句柄总是可见的。

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

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

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

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

标识符

全部展开

此属性是只读的。

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

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

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

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

兼容性的考虑

全部展开

不建议在R2020a开始

之前介绍过的R2006a