主要内容

轮廓属性

轮廓图的外观和行为

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

[C,h]=轮廓(…);w=h.线宽;h.线宽=2;

水平

全部展开

轮廓标高,指定为z值的向量。默认情况下外形函数选择跨中的值范围的值兹达塔财产。

设置此属性将关联模式属性设置为手动。

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64

的选择模式水平表,指定为以下值之一:

  • “汽车”—根据数据类型选择兹达塔价值观

  • “手册”-使用手动指定的值。要指定值,请设置水平表属性。当模式为手动时外形函数不会在更改时更改值兹达塔

等高线之间的间距,指定为标量数值。例如,指定值2以绘制以2为增量的等高线。的外形函数根据轮廓确定轮廓间隔兹达塔价值观

设置此属性将关联模式属性设置为手动。

例子:3.4

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64

的选择模式水平台阶,指定为以下值之一:

  • “汽车”-根据计算结果确定值兹达塔价值观

  • “手册”-使用手动指定的值。若要指定该值,请设置水平台阶属性。当模式为手动时外形函数不会在更改时更改值兹达塔

沿线等高线的位置z-轴,指定为以下值之一:

  • “zmin”-将轮廓定位到最小值z-打印框中的级别。这是打印的默认位置冲浪运动meshc情节。

  • “zmax”—将轮廓线置于最大位置z-“打印”框中的标高。

  • 标量数值-将等高线置于指定位置z-级别。使用外形轮廓使用的值为0默认情况下。

请注意

控件创建的3-D等高线图上设置此属性轮廓3功能没有效果。

色彩与造型

全部展开

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

  • “关闭”-不要用颜色填充等高线之间的空间。这是使用创建等高线图时的默认值外形轮廓3功能。

  • “上”-用颜色填充等高线之间的空格。这是使用创建等高线图时的默认值轮廓函数。

等高线的颜色,指定为“平”、RGB三元组、十六进制颜色代码、颜色名称或短名称。若要为每个等高线使用不同的颜色,请指定“平”。颜色由线条的轮廓值、颜色贴图以及将数据值缩放到颜色贴图中来确定。有关颜色缩放的更多信息,请参阅卡西斯

要对所有等高线使用相同的颜色,请指定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) “#00FFFF”

青色样品

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

样品的颜色为洋红色

“黄色” “是的” (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.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],呈暗红色

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

线条样式 描述 结果线
“- - -” 实线

实线样本

'--' 虚线

虚线样本

':' 虚线

虚线样本

'-.' Dash-dotted线

虚线样品,带有交替的虚线和圆点

“没有” 没有线 没有线

等高线宽度,指定为点上的正值。一点等于1/72英寸。

标签

全部展开

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

  • “上”-沿等高线显示高度值。

  • “关闭”-不要给轮廓线贴标签。

标记沿等高线的间距,指定为点标量值,其中一个点为1/72英寸。使用此属性可控制沿轮廓线的轮廓标签的数量。更小的值产生更多的标签。

你必须设置ShowText财产“上”标签间隔属性具有影响。

如果你使用clabel函数来显示标签,然后使用标签间隔属性无效,并且打印每行显示一个标签。

带标签的等高线之间的间隔,指定为标量数值。默认情况下,等高线图包含每个等高线的标签ShowText属性设置为“上”

设置此属性将关联模式属性设置为手动。

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64

的选择模式文本步骤,指定为以下值之一:

  • “汽车”-根据兹达塔价值观如果ShowText属性设置为“上”,然后外形功能标记每条等高线。

  • “手册”-使用手动指定的值。若要指定该值,请设置文本步骤财产。

等高线的标号,指定为实值向量。

设置此属性将关联模式属性设置为手动。

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64

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

  • “汽车”-使用的值等于水平表属性。等高线图包括每条线的文本标签。

  • “手册”—使用手动设置的值。属性指定值TextList财产。

数据

全部展开

此属性是只读的。

轮廓矩阵,返回为两行矩阵。这个矩阵包含等高线层(高度)和每一层顶点的坐标。数据按n条等高线排列在n组列中:

  • 每组中的第一列包含轮廓级别和该级别的顶点数。顶部编号是轮廓标高,底部编号是顶点数。

  • 集合中的后续列是(xy)顶点的坐标。每列表示一个有序对。最上面的数字是x-坐标,底部的数字是y-协调。

例如,这是等高线矩阵的前几列M =轮廓(峰值(3))

x值,指定为向量或矩阵。

  • 如果XData那么,这是一个向量长度(XData)必须等于大小(ZData, 2)伊达塔也必须是一个向量。的XData值必须严格递增或严格递减,且不能包含任何重复。

  • 如果XData是一个矩阵大小(XData)尺寸(YData)必须等于尺寸(ZData). 通常,您应该设置XData值,使列严格递增或严格递减且行是一致的(或行严格递增或严格递减且列是一致的)。

设置此属性将关联模式属性设置为手动。

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

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

  • “汽车”——设置XData使用兹达塔

  • “手册”-使用手动指定的值。要指定值,请设置XData属性,或指定输入参数X外形轮廓轮廓3函数。

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

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

请注意

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

例子:“x”

y值,指定为向量或矩阵。

  • 如果伊达塔那么,这是一个向量长度(YData)必须等于尺寸(ZData,1)XData也必须是一个向量。的XData值必须严格递增或严格递减,且不能包含任何重复。

  • 如果伊达塔是一个矩阵大小(XData)尺寸(YData)必须等于尺寸(ZData). 通常,您应该设置伊达塔值,使列严格递增或严格递减且行是一致的(或行严格递增或严格递减且列是一致的)。

设置此属性将关联模式属性设置为手动。

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

的选择模式伊达塔,指定为以下值之一:

  • “汽车”——设置伊达塔使用的行索引兹达塔

  • “手册”-使用手动指定的值。要指定值,请设置伊达塔属性,或指定输入参数Y外形轮廓轮廓3函数。

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

默认情况下,没有链接变量,因此该值为空字符向量,''.如果你链接一个变量,那么MATLAB不会更新伊达塔立即恢复价值。要强制更新数据值,请使用refreshdata函数。

请注意

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

例子:“是的”

定义曲面到轮廓的数据,指定为矩阵。兹达塔必须至少是2×2矩阵。

设置此属性将关联模式属性设置为手动。

数据类型:仅有一个的|双重的|int8|int16|int32|int64|uint8|uint16|uint32|uint64

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

默认情况下,没有链接变量,因此该值为空字符向量,''.如果你链接一个变量,那么MATLAB不会更新兹达塔立即恢复价值。要强制更新数据值,请使用refreshdata函数。

请注意

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

例子:“z”

传说

全部展开

图例标签,指定为字符向量或字符串标量。只有调用传奇命令。如果不指定文本,则传奇使用表单设置标签“达坦”

此属性是只读的。

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

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

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

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

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

或者,您可以使用传奇作用将第一个输入参数指定为要包含的图形对象的向量。如果未在第一个输入参数中指定现有图形对象,则该对象不会显示在图例中。但是,创建图例后添加到轴的图形对象确实会显示在图例中。在创建所有的图以避免额外的项目后,考虑创建图例。

互动性

全部展开

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

  • “上”-显示对象。

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

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

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

请注意

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

上下文菜单,指定为上下文菜单对象使用此属性可以在右键单击对象时显示关联菜单。使用uicontextmenu函数。

请注意

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

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

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

  • “关闭”-未选择。

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

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

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

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

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

  • 的值“关闭”显示整个对象,即使其部分显示在轴限制之外。如果创建打印,则对象的某些部分可能会显示在轴限制之外等等,冻结轴缩放,然后创建对象,使其大于原始打印。

剪辑包含对象的轴的属性必须设置为“上”. 否则,此属性无效。有关剪裁行为的详细信息,请参见剪辑轴的性质。

回调

全部展开

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

  • 函数句柄

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

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

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

  • Clicked object—从回调函数中访问单击对象的属性。

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

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

请注意

如果易损件属性设置为“没有”或者如果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将继续执行正在运行的回调。

请注意

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

  • 如果中断回调是DeleteFcn关闭请求FCNSizeChangedFcn回调,则中断发生,而不考虑打断属性值。

  • 如果正在运行的回调当前正在执行等待函数,则无论打断属性值。

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

请注意

发生中断时,MATLAB不会保存属性或显示的状态。例如,由gcagcf当执行另一个回调时,命令可能会更改。

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

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

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

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

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

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

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

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

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

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

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

  • “上”——触发按钮向下收回外形对象。如果你定义了上下文菜单属性,然后调用上下文菜单。

  • “关闭”对象的最近祖先触发回调外形对象,该对象具有以下之一:

    • HitTest属性设置为“上”

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

请注意

易损件属性决定外形对象可以捕获鼠标单击。如果不能,则HitTest财产无效。

此属性是只读的。

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

MATLAB设置被删除财产“上”DeleteFcn回调开始执行。这个被删除属性仍设置为“上”直到组件对象不再存在。

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

父母/子女

全部展开

父级,指定为使改变对象。

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

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

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

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

  • “关闭”-对象句柄始终不可见。此选项有助于防止其他函数进行意外更改。设定可操作性“关闭”在执行该函数期间临时隐藏句柄。

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

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

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

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“轮廓”

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

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

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

兼容性考虑

全部展开

不建议在R2020a中起动

在R2006a之前引入