主要内容

块的属性

补丁外观和行为

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

P = patch;c = p.CData;p.CDataMapping = 'scaled';

颜色

全部展开

表面颜色,指定为的插值函数“平”RGB三元组、十六进制颜色代码、颜色名称或短名称。

要为每个面创建不同的颜色,请指定CDataFaceVertexCData属性为每个面包含一种颜色或每个顶点包含一种颜色的数组。颜色可以从每个面周围顶点的颜色中插入,也可以是均匀的。对于插值颜色,将此属性指定为的插值函数。对于统一的颜色,指定此属性为“平”。如果你指定“平”每个顶点都有不同的颜色,你指定的第一个顶点的颜色决定了面色。

若要为所有面指定单一颜色,请将此属性指定为RGB三元组、十六进制颜色代码、颜色名称或短名称。

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

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

颜色名称 短名称 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”

“没有” 不适用 不适用 不适用 没有颜色

这里是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 0 0]。如果多个多边形共享一条边,则绘制的第一个多边形控制显示的边颜色。

价值 描述 结果

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

所有的边都是单色。详情见下表。

“平”

每条边都有不同的颜色。使用顶点颜色来设置它后面的边的颜色。您必须首先指定CDataFaceVertexCData作为每个顶点包含一种颜色的数组。边缘颜色取决于指定顶点的顺序。

的插值函数

插值边缘颜色。您必须首先指定CDataFaceVertexCData作为每个顶点包含一种颜色的数组。通过线性插值两个边界顶点的值来确定边缘颜色。

“没有” 没有显示边。

没有显示边。

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”

[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”

补丁颜色数据,指定为整个补丁的单一颜色,每个面一种颜色,或每个顶点一种颜色。

这种方式补丁功能解释CData取决于所提供的数据类型。指定CData以下列形式之一:

  • 按比例线性映射到当前颜色映射的数值。

  • 直接用作当前颜色映射索引的整数值。

  • RGB三元组的数组。RGB三联体不被映射到当前颜色映射,而是解释为定义的颜色。

下面的图表说明的尺寸CData的数组XDataYData,ZData属性。

这些图表说明了索引颜色的使用。

这些图表说明了真实色彩的使用。真彩色需要一个RGB三元组或一个RGB三元组数组。

如果CData则包含nan补丁不会给脸上色。

定义补丁的另一种方法使用顶点,FaceVertexCData属性。

例子:(1,0,0)

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

面和顶点颜色,指定为整个补丁的单一颜色,每个面一种颜色,或为插值的面颜色每个顶点一种颜色。

如果您想使用索引颜色,请指定FaceVertexCData以下列形式之一:

  • 对于整个补丁的一种颜色,使用单个值。

  • 对于每个面都有一种颜色,使用m × 1列向量,其中m是表中的行数财产。

  • 对于插值的面部颜色,使用m × 1列向量,其中m是数据中的行数顶点财产。

如果你想使用真实的颜色,请指定FaceVertexCData以下列形式之一:

  • 对于所有面的一种颜色,指定一个定义RGB三元组的三元素行向量。执行此操作时,还必须设置FaceColor“平”EdgeColor到一个值以外“平”的插值函数

  • 对于每个面都有一种颜色,使用一个m × 3的RGB三元组数组,其中m是数组中的行数财产。

  • 对于插值的面部颜色,使用m × 3数组,其中m是数组中的行数顶点财产。

的各种形式FaceVertexCData属性用于具有八个面和九个顶点的补丁。的CDataMapping属性决定了MATLAB如何解释FaceVertexCData属性指定索引颜色时。

直接或比例的颜色数据映射,指定为“缩放”(默认值)或“直接”。的CDataFaceVertexCData属性包含颜色数据。如果你使用真色规格CDataFaceVertexCData,则此属性无效。

  • “直接”-将这些值解释为当前颜色图的索引。带有小数部分的值被固定为最近的低整数。

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

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

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

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

透明度

全部展开

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

  • 范围内的标量[0, 1]-在所有面部使用统一的透明度。值为1是完全不透明的0是完全透明的。属性中的透明度值FaceVertexAlphaData财产。

  • “平”的值为每个面使用不同的透明度FaceVertexAlphaData财产。首先,必须指定FaceVertexAlphaData属性作为每个面或顶点包含一个透明度值的向量。第一个顶点的透明度值决定了整个人脸的透明度。

  • 的插值函数-使用插值的透明度为每个面基于的值FaceVertexAlphaData财产。首先,必须指定FaceVertexAlphaData属性作为每个顶点包含一个透明度值的向量。通过插值顶点上的值,每个面的透明度都不同。

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

  • 范围内的标量值[0, 1]-在所有边缘上使用统一的透明度。值为1是完全不透明的0是完全透明的。属性中的透明度值FaceVertexAlphaData财产。

  • “平”属性中的值为每条边使用不同的透明度FaceVertexAlphaData财产。首先,必须指定FaceVertexAlphaData属性作为每个面或顶点包含一个透明度值的向量。第一个顶点的透明度值决定了边缘的透明度。

  • 的插值函数-使用插值透明度为每条边的基础上的值FaceVertexAlphaData财产。首先,必须指定FaceVertexAlphaData属性作为每个顶点包含一个透明度值的向量。通过在顶点处插入值来改变每条边的透明度。

面和顶点透明度值,指定为标量、每个面有一个值的向量或每个顶点有一个值的向量。

  • 若要在所有面或边上保持一致的透明度,请指定一个标量值。然后,设置FaceAlphaEdgeAlpha财产“平”

  • 为每个面或边指定不同的透明度-by-1向量,其中是面数。然后,设置FaceAlphaEdgeAlpha财产“平”。对象中的行数可确定面数财产。

  • 对于跨每个面或边的插值透明度,请指定n-by-1向量,其中n是顶点的数目。然后,设置FaceAlphaEdgeAlpha财产的插值函数。对象中的行数可确定顶点数顶点财产。

AlphaDataMapping属性确定补丁如何解释FaceVertexAlphaData属性值。

请注意

如果FaceAlphaEdgeAlpha属性均设置为标量值,则补丁不使用FaceVertexAlphaData值。

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

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

  • “缩放”-将值映射到图形的alphamap中。轴的最小和最大alpha限制分别确定映射到alphamap中的第一个和最后一个元素的alpha数据值。例如,如果极限是[3 - 5],则alpha数据值小于或等于3.映射到alphamap中的第一个元素。数据值大于等于5映射到alphamap中的最后一个元素。的阿利姆属性的轴包含alpha极限。的Alphamap属性包含字母映射。

  • “直接”-将值解释为图形字母图的索引。带有小数部分的值被固定为最近的低整数。

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

    • 如果值为整型,则0或更小的值映射到alphamap中的第一个元素。值等于或大于alphamap映射到alphamap中最后一个元素的长度(或不超过该类型的范围限制)。整数类型为uint8uint16uint32uint64int8int16int32,int64

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

线的样式

全部展开

线条样式,指定为本表中列出的选项之一。

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

“——” 虚线

“:” 虚线

“-”。 Dash-dotted线

“没有” 没有线 没有线

线宽,以点为单位的正值,其中1点= 1/72英寸。如果行有标记,则行宽也会影响标记边。

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

线角的样式,指定为“圆”“斜”,或“倒角”。下表说明了不同值的外观。

“圆” “斜” “倒角”

外观“圆”选项看起来可能有所不同渲染器属性设置为opengl的而不是“画家”

尖锐的垂直和水平线,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于。因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值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]

  • 十六进制颜色码是字符向量或以散列符号()后面跟着三个或六个十六进制数字,取值范围为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”

[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]

  • 十六进制颜色码是字符向量或以散列符号()后面跟着三个或六个十六进制数字,取值范围为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”

[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”

数据

全部展开

顶点连接定义每个面,指定为定义顶点的向量或矩阵顶点属性,这些属性将被连接以形成每个面。的顶点属性提供了一种指定补丁的替代方法,这种方法比使用更有效XDataYData,ZData坐标在大多数情况下。

faces数组中的每一行都指定了单个面的连接,以及该行中不连接的元素的数量定义该面的顶点数。因此,m × n矩阵数组定义了m个面,每个面最多有n个顶点。

例如,考虑以下补丁。它由八个三角形面组成,由九个顶点定义。相应的顶点属性显示在补丁的右侧。注意一些面如何与其他面共享顶点。例如,第五个顶点(V5)使用了六次,分别在第1、2、3、6、7和8面使用一次。没有共享顶点,这个补丁需要24顶点定义。

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

顶点坐标,指定为向量或定义(xyz)每个顶点的坐标。的顶点属性提供了一种指定补丁的替代方法,这种方法比使用更有效XDataYData,ZData坐标在大多数情况下。看到属性用于描述如何使用顶点数据。

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

x- patch顶点的坐标,指定为向量或矩阵。如果XData是一个矩阵,那么每一列表示的是x-补丁单面坐标。在这种情况下,XDataYData,ZData必须有相同的尺寸。

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

y-坐标定义补丁,指定为向量或矩阵。如果YData是一个矩阵,那么每一列表示的是y-补丁单面坐标。在这种情况下,XDataYData,ZData必须有相同的尺寸。

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

z- patch顶点的坐标,指定为向量或矩阵。如果ZData是一个矩阵,那么每一列表示的是z-补丁单面坐标。在这种情况下,XDataYData,ZData必须有相同的尺寸。

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

法线

全部展开

顶点法向量,指定为法向量数组,每个贴片顶点有一个法向量。属性的大小决定每个补丁顶点定义一个法线顶点顶点属性值。顶点法线决定贴片的形状和方向。这些数据用于照明计算。

指定此属性的值会将关联模式设置为手动。如果您没有指定法向量,那么当轴包含轻对象时,补丁将生成此数据。

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

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

  • “汽车”- - -补丁函数在添加灯光到场景时计算顶点法线。

  • “手动”参数指定的顶点法线数据VertexNormals财产。将值赋给VertexNormals属性集VertexNormalsMode“手动”

面法向量,指定为法向量数组,每个贴片面有一个法向量。的大小决定每个补丁面定义一个法线属性值。面法线决定每个贴片面的方向。这些数据用于照明计算。

指定此属性的值会将关联模式设置为手动。如果您没有指定法向量,那么当轴包含轻对象时,补丁将生成此数据。该贴片使用纽维尔方法计算面部法线。

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

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

  • “汽车”- - -补丁函数在向场景中添加灯光时计算面法线。

  • “手动”—使用FaceNormals财产。将值赋给FaceNormals属性集FaceNormalsMode“手动”

照明

全部展开

浅色物体在表面上的效果,指定为以下值之一:

  • “平”-将光线均匀地照射在每一张脸上。使用此值查看多面对象。

  • “古尔戈”-改变脸部的光线。计算顶点处的光线,然后线性插值光线穿过各个面。使用此值查看曲面。

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

要向坐标轴添加一个轻对象,请使用函数。

请注意

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

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

  • “reverselit”-如果顶点法线指向相机,照亮脸部。

  • “灯”-不要在脸上打光。

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

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

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

  • “平”-在每个边缘均匀地施加光线。

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

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

请注意

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

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

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

例子:0.5

数据类型:

漫射光的强度,指定为范围内的标量值[0, 1]。漫射光是由轴上的轻物体产生的非镜面反射。

例子:0.3

数据类型:

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

例子:0.3

数据类型:

镜面反射的膨胀程度,指定为大于的标量值0SpecularExponent控制镜面反射光斑的大小。数值越大,镜面反射越少。

大多数材料的指数在520.

例子:17

数据类型:

镜面反射的颜色,指定为之间的标量01包容性。

  • 0镜面反射的颜色取决于反射物体的颜色和光源的颜色。

  • 1-镜面反射的颜色只取决于颜色或光源(即发光物体)颜色属性)。

光源颜色和贴片颜色对镜面反射颜色的贡献在两者之间线性变化01

例子:0.5

数据类型:|

传说

全部展开

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

此属性是只读的。

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

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

  • “关闭”—图例中不包含该对象。

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

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

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

交互性

全部展开

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

  • “上”—显示对象。

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

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

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

此属性仅适用于带有固定数据提示的补丁。

请注意

DataTipTemplate返回的findobjfindall,它不会被复制copyobj

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

请注意

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

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

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

  • “关闭”—未选中。

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

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

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

剪切对象到轴限制,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真,和“关闭”等于。因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • 值为“上”剪辑超出轴限制的对象部分。

  • 值为“关闭”显示整个对象,即使部分对象出现在轴限制之外。对象的部分可能出现在轴限制之外,如果您创建一个绘图,设置抓住,冻结轴缩放,然后创建对象,使其比原始图更大。

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

回调

全部展开

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

  • 函数处理

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

  • 是有效的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拥有中断回调的对象的属性决定中断回调是被丢弃还是放入队列。

请注意

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

  • 如果中断回调是DeleteFcnCloseRequestFcnSizeChangedFcn回调函数时,中断发生,而不管可中断属性值。

  • 方法当前正在执行等待函数,则中断发生而不管可中断属性值。

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

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

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

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

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

每当MATLAB调用回调时,该回调都会试图中断正在运行的回调。的可中断属性决定是否允许中断。如果不允许中断,则BusyAction拥有中断回调的对象的属性确定它是被丢弃还是放入队列中。的可能值BusyAction属性:

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

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

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

  • “可见”-捕捉鼠标点击时可见。的可见属性必须设置为“上”并且你必须点击其中的一部分补丁具有已定义颜色的对象。不能单击已将关联颜色属性设置为的部件“没有”。如果绘图包含标记,则如果边缘或填充有定义的颜色,则整个标记都是可单击的。的HitTest属性确定是否补丁对象对单击做出响应,或者如果一个祖先响应。

  • “所有”-捕获鼠标点击,无论是否可见。的可见属性可以设置为“上”“关闭”你可以点击其中的一部分补丁没有颜色的对象。的HitTest属性确定是否补丁对象对单击做出响应,或者如果一个祖先响应。

  • “没有”—无法捕获鼠标点击。单击补丁对象在图形窗口的当前视图中将单击传递给它下面的对象。的HitTest财产没有影响。

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

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

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

    • HitTest属性设置为“上”

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

请注意

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

此属性是只读的。

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

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

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

父/子

全部展开

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

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

属性不能添加或删除子元素孩子们财产。要将子元素添加到此列表中,请设置的属性DataTip对象添加到图表对象。

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

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

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

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

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

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

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“补丁”。使用此属性可在绘图层次结构中查找给定类型的所有对象,例如,搜索使用的类型findobj

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

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

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

兼容性的考虑

全部展开

不建议从R2020a开始

R2006a之前介绍