文档

FunctionContour属性

等高线图表外观和行为

FunctionContour属性的外观和行为FunctionContour对象。通过更改属性值,可以修改等高线图的某些方面。

水平

全部展开

等高线水平,指定为矢量的z值。默认情况下,fcontour属性中的值范围内的值ZData财产。

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

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

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

  • “汽车”—请根据实际情况确定ZData值。

  • “手动”—使用手动设置的值。要指定值,请设置LevelList财产。当模式为“手动”,LevelList的值不会改变函数属性或者极限。

等高线之间的间距,指定为标量数值。例如,指定值为2以2为增量画等高线。默认情况下,LevelStep是由使用ZData值。

设置此属性会将关联的模式属性设置为“手动”

例子:3.4

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

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

  • “汽车”—请根据ZData值。

  • “手动”—使用手动设置的值。要指定该值,请设置LevelStep财产。当模式为“手动”的值。LevelStepMode不改变时函数财产或限制改变。

颜色和样式

全部展开

在等高线之间填充,指定为以下值之一:

  • “关闭”—不要在等高线之间填充颜色。

  • “上”—等高线之间用颜色填充。

等高线的颜色,指定为“平”, RGB三元组,或表中列出的颜色选项之一。

  • 若要为每条等高线使用不同的颜色,请指定“平”.颜色由线条的等高线值、色度图和数据值到色度图的比例决定。有关颜色缩放的更多信息,请参见caxis

  • 若要对所有等高线使用相同的颜色,请从表中指定RGB三元组或其中一个颜色选项。

对于自定义颜色,指定一个RGB三元组。RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7].或者,您可以通过名称指定一些常用颜色。该表列出了长颜色和短颜色名称选项以及等效的RGB三元组值。

选项 描述 等效RGB三元组
“红色”“r” 红色的 [10 0 0]
“绿色”‘g’ 绿色 [0 10 0]
“蓝”“b” 蓝色的 [0 0 1]
“黄色”“y” 黄色的 [11 10 0]
“红色”“米” 品红色的 [10 0 1]
“青色”“c” 青色 [0 1 1]
“白色”' w ' 白色 [1 1 1]
“黑”“k” 黑色的 [0 0 0]
“没有” 没有颜色 不适用

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

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

“——” 虚线

“:” 虚线

“-”。 Dash-dotted线

“没有” 没有线 没有线

线宽,以点为单位指定为正值。如果行有标记,则行宽也会影响标记边。

例子:0.75

函数

全部展开

函数进行绘图,指定为函数句柄、匿名函数或符号表达式或函数。

标绘间隔x值,指定为形式的两元素向量[xmin xmax]

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

  • “汽车”—使用默认值5 [5].如果指定了轴限制,则遵循指定的限制。

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

标绘间隔y值,指定为形式的两元素向量[ymin ymax]

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

  • “汽车”—使用默认值5 [5].如果指定了轴限制,则遵循指定的限制。

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

每个方向的评估点数,用数字指定。默认为71.因为fcontour采用自适应评价,实际评价点数量较大。

例子:30.

数据

全部展开

此属性是只读的。

等高线定义,作为两行矩阵返回。图中的每条等高线都有一个相关的定义。如果情节有一共N等高线,则等高线矩阵由N定义:

C = [C(1) C(2)…C(k)…C(N)]
每个等高线定义都遵循以下模式:
C(k) =[水平x(1) x(2)…Numxy y(1) y(2)…]
第一个条目,水平,表示等高线所在的等高线高度。等高线下面是(xy)定义等高线的顶点。其余列包含每个顶点的数据。如果第一个顶点和最后一个顶点相同,则等高线是一个闭环。如果一个特定的等高线层在图中有多条等高线,则矩阵包含每条线的单独定义。

例子

的等高线图X²+ y².为了演示,请使用最低的MeshDensity这就形成了一个图3.

H = fcontour(@(x,y) x.^2+y.^2,“MeshDensity”3);网格

方法访问轮廓矩阵ContourMatrix轮廓对象的属性(h.ContourMatrix).轮廓矩阵包含了七条轮廓线中的每一条的定义。这个矩阵中的圆表示等高线定义的起点。

矩阵中的第一个定义表示有一条等高线画在5层,由五个顶点组成(1,0)(0,1)(1,0)(0,1),(1,0).由于第一个顶点和最后一个顶点是相同的,等高线是一个闭环。最后一个定义表示在点处有一个点50水平,因为直线开始和结束于同一点,没有中间点。

此属性是只读的。

x作为矩阵指定的值。XData至少是一个2 × 2矩阵。大小(XData)大小(YData),大小(ZData)是相等的。

此属性是只读的。

y值,指定为矩阵。YData至少是一个2 × 2矩阵。大小(XData)大小(YData),大小(ZData)是相等的。

此属性是只读的。

定义曲面到轮廓的数据,指定为矩阵。ZData至少是一个2 × 2矩阵。大小(XData)大小(YData),大小(ZData)是相等的。

传说

全部展开

图例标签的文本,指定为自定义字符向量或字符串。属性自动生成默认标签函数财产和texlabel函数。方法之前,图例不会出现传说函数。

数据类型:字符|字符串

此属性是只读的。

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

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

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

例如,从图例中排除一个干图。

P = plot(1:10,“DisplayName的”“折线图”);持有S =茎(1:10,“DisplayName的”“茎图”);持有s.Annotation.LegendInformation.IconDisplayStyle =“关闭”;传奇(“显示”

控件控制图例中的项传说函数。将第一个输入参数指定为要包含的图形对象的向量。

P = plot(1:10,“DisplayName的”“折线图”);持有S =茎(1:10,“DisplayName的”“茎图”);持有传奇(p)

交互性

全部展开

可见性状态,指定为以下值之一:

  • “上”—显示对象。

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

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

请注意

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

选择状态,指定为以下值之一:

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

  • “关闭”—未选中。

选择时显示选择句柄,指定为以下值之一:

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

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

回调

全部展开

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

  • 函数处理

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

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

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

  • 点击对象-从回调函数中访问点击对象的属性。

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

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

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则此回调不执行。

创建回调,指定为以下值之一:

  • 函数处理

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

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

在创建对象时使用此属性执行代码。MATLAB在创建对象并设置其所有属性后执行回调。设置CreateFcn属性对现有对象不起作用。要产生效果,必须指定CreateFcn属性。在对象创建期间指定属性的一种方法是为对象设置默认属性值。看到默认属性值获取更多信息。

如果使用函数句柄指定此回调,则MATLAB在执行回调时将两个参数传递给回调函数:

  • 已创建对象-从回调函数中访问对象的属性。方法访问对象CallbackObject属性,该属性可以使用gcbo函数。

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

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

删除回调,指定为以下值之一:

  • 函数处理

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

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

在删除对象时使用此属性执行代码MATLAB在销毁对象之前执行回调,以便回调可以访问其属性值。

如果使用函数句柄指定此回调,则MATLAB在执行回调时将两个参数传递给回调函数:

  • 删除对象-从回调函数中访问对象的属性。方法访问对象CallbackObject属性,该属性可以使用gcbo函数。

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

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

回调执行控制

全部展开

回调中断,指定为“上”“关闭”.的可中断属性确定正在运行的回调是否可以中断。

请注意

考虑以下回调状态:

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

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

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

可中断属性确定另一个回调是否可以中断ButtonDownFcn的回调FunctionContour对象。的可中断属性有两个值:

  • “上”——可中断。中断发生在下一个MATLAB处理队列的点。例如,当您有这样的命令时drawnow数字getframe等待,或暂停

    • 如果正在运行的回调包含这些命令之一,那么MATLAB将在此时停止回调的执行并执行中断回调。当中断回调完成时,MATLAB恢复执行正在运行的回调。有关更多信息,请参见中断回调执行

    • 如果正在运行的回调不包含这些命令之一,那么MATLAB将不间断地完成回调的执行。

  • “关闭”-不可打断。MATLAB在没有任何中断的情况下完成运行回调的执行。

回调队列指定为“队列”“取消”.的BusyAction属性决定MATLAB如何处理中断回调的执行。

考虑以下回调状态:

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

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

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

的回调函数FunctionContour对象试图中断不可中断的正在运行的回调,则BusyAction属性确定它是被丢弃还是放入队列中。指定BusyAction属性作为以下值之一:

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

  • “取消”—丢弃中断回调。

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

  • “可见”-仅在可见时捕获鼠标单击。的可见属性必须设置为“上”.的HitTest属性确定是否FunctionContour对象对单击做出响应,或者如果一个祖先响应。

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

对捕获的鼠标单击的响应,指定为以下值之一:

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

  • “关闭”类的最近祖先的回调FunctionContour对象,具有:

    • HitTest属性设置为“上”

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

请注意

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

此属性是只读的。

删除状态,返回为“关闭”“上”.MATLAB设置BeingDeleted财产“上”当对象的delete函数开始执行时(请参阅DeleteFcn属性)。的BeingDeleted属性仍然设置为“上”直到该对象不再存在。

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

父/子

全部展开

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

对象没有子对象。您不能设置此属性。

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

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

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

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

属性中未列出对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数不能返回它。例如,当你有一个函数得到findobjgcagcfgconewplotclf,关闭

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

标识符

全部展开

此属性是只读的。

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

标记来关联functioncontour对象,指定为字符向量或字符串标量。

使用此属性查找functioncontour层次结构中的对象。例如,您可以使用findobj函数查找functioncontour具有特定标签属性值。

例子:“1月数据”

数据类型:字符|字符串

相关联的用户数据functioncontour对象,指定为任何MATLAB数据,例如标量、向量、矩阵、单元格数组、字符数组、表或结构。MATLAB不使用这些数据。

要关联多组数据或将字段名附加到数据,请使用getappdata而且setappdata功能。

例子:1:100

在R2016a中引入

这个话题有用吗?