主要内容

轮廓属性

轮廓图的外观和行为

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

(C、h) =轮廓(…);w = h.LineWidth;h.LineWidth = 2;

水平

全部展开

等值线水平,指定为z值向量。默认情况下,轮廓函数选择范围内的值ZData财产。

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

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

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

  • “汽车”—根据数据类型选择ZData值。

  • “手动”—使用手动设置的值。要指定值,请设置LevelList财产。当模式为手动时,则轮廓函数不会随着您的更改而更改值ZData

等高线之间的间距,指定为标量数值。例如,指定值2以绘制以2为增量的等高线。的轮廓函数根据ZData值。

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

例子:3.4

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

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

  • “汽车”—根据数据类型选择ZData值。

  • “手动”—请使用手动设置的值。要指定值,请设置LevelStep财产。当模式为手动时,则轮廓函数不会随着您的改变而改变值ZData

轮廓线的位置z-axis,指定为以下值之一:

  • “zmin”—将轮廓置于最小位置z-level在情节盒中。这是默认的位置surfcmeshc情节。

  • “zmax”—将轮廓线置于最大位置z-level在情节盒中。

  • 标量数值-将等高线置于指定位置z水平的。用轮廓contourf使用值0默认情况下。

请注意

控件创建的3-D等高线图上设置此属性contour3函数没有作用。

颜色和样式

全部展开

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

  • “关闭”—不要用颜色填充等高线之间的空间。属性创建等高线图时,此值为默认值轮廓contour3功能。

  • “上”—用颜色填充等高线之间的空间。属性创建等高线图时,此值为默认值contourf函数。

等高线的颜色,指定为“平”、RGB三元组、十六进制颜色代码、颜色名称或短名称。若要为每个等高线使用不同的颜色,请指定“平”.颜色是由线条的等高线值、颜色图以及数据值在颜色图中的比例决定的。有关颜色缩放的更多信息,请参见caxis

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

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

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

“——” 虚线

“:” 虚线

“-”。 Dash-dotted线

“没有” 没有线 没有线

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

标签

全部展开

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

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

  • “关闭”—不要在等高线上做标记。

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

你必须设置ShowText财产“上”LabelSpacing属性具有影响。

如果你使用clabel函数来显示标签,然后使用LabelSpacing属性没有影响,并且绘图每行显示一个标签。

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

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

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

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

  • “汽车”—根据该值确定ZData值。如果ShowText属性设置为“上”,那么轮廓功能标记每条等高线。

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

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

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

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

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

  • “汽车”—使用与的值相等的值LevelList财产。等高线图包括每一行的文本标签。

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

数据

全部展开

此属性是只读的。

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

  • 每个集合中的第一列包含等高线水平和该水平顶点的数量。上面的数字是等高线水平,下面的数字是顶点的数量。

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

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

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

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

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

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

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

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

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

  • “手动”—使用手动设置的值。要指定值,请设置XData属性,或指定输入参数X轮廓contourf,或contour3函数。

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

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

请注意

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

例子:“x”

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

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

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

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

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

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

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

  • “手动”—使用手动设置的值。要指定值,请设置YData属性,或指定输入参数Y轮廓contourf,或contour3函数。

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

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

请注意

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

例子:“y”

将表面定义为轮廓线的数据,指定为矩阵。ZData至少是一个2 × 2矩阵。

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

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

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

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

请注意

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

例子:“z”

传说

全部展开

图例标号,指定为字符向量或字符串标量。图例不会显示,直到你调用传说命令。如果不指定文本,则传说使用表单设置标签“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财产的轮廓对象没有效果。

对捕获的鼠标单击的响应,指定为“上”“关闭”,或数字或逻辑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