主要内容

区域属性

区域图外观和行为

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

Ar =面积(1:10);ar.EdgeColor = 'red';

颜色和样式

全部展开

区域填充颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或“平”

从R2017b开始,默认值是RGB三元组ColorOrder坐标轴的性质。在以前的版本中,默认值为“平”颜色是根据颜色图来的。

对于自定义颜色,请指定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飞行符”

样品的颜色为青色

“红色” “m” [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”

RGB三联体[0 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] “# 7 e2f8e”

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],呈暗红色

控制FaceColor属性,指定为以下值之一:

  • “汽车”的值的MATLAB控件FaceColor属性中选择颜色ColorOrder坐标轴的性质。

  • “手动”的值FaceColor属性,方法是在调用创建对象的绘图函数时指定颜色,或者通过设置FaceColor属性。

的值FaceColor属性手动,MATLAB更改的值FaceColorMode财产“手动”

区域轮廓颜色,指定为RGB三元组、十六进制颜色代码、颜色名称或“平”.将此属性指定为“平”使用颜色图的颜色。

对于自定义颜色,请指定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飞行符”

样品的颜色为青色

“红色” “m” [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”

RGB三联体[0 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] “# 7 e2f8e”

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],呈暗红色

表面透明度,指定为范围内的标量[0, 1].值1是不透明的,0是完全透明的。0到1之间的值是半透明的。

例子:a.FaceAlpha = 0.5;

边缘透明度,指定为范围内的标量[0, 1].值1是不透明的,0是完全透明的。0到1之间的值是半透明的。

例子:a.EdgeAlpha = 0.5;

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

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

实线样本

”——“ 虚线

虚线样本

”:“ 虚线

虚线样本

“-”。 Dash-dotted线

虚线样例,虚线和点交替使用

“没有” 没有线 没有线

区域轮廓宽度,指定为点单位的标量数值。1分等于1/72英寸。

例子:1.5

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

系列索引,指定为大于或等于的整数0.此属性用于重新分配多个对象的表面颜色区域对象,使它们相互匹配。默认情况下,SeriesIndex的属性区域对象是一个与它的创建顺序相对应的数字,从1

MATLAB在调用绘图函数时使用该数字计算分配面部颜色的索引。对象中存储的数组的行ColorOrder坐标轴的性质。

MATLAB自动更新人脸的颜色区域对象SeriesIndex或者当你改变的时候ColorOrder坐标轴上的性质。然而,以下条件必须是正确的改变有任何效果:

  • FaceColorMode的属性区域对象设置为“汽车”

  • SeriesIndex的属性区域对象的值大于0

  • NextSeriesIndex属性的值大于0

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

价值 描述 外观
“上”

磨尖垂直和水平的线条,以消除不均匀的外观。

四条垂直的线条很锋利

“关闭”

不要锐化垂直或水平线。线条可能在粗细和颜色上不均匀。

四条粗细不均匀的竖线。有些线条很模糊。

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

请注意

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

基线

全部展开

基线值,指定为数值标量。基线值指定y水平基线的-坐标。面积图填充数据值和基线之间的区域。

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

  • “上”-显示基线。

  • “关闭”—隐藏基线。

此属性是只读的。

基准对象。有关基线属性的列表,请参见基本属性

数据

全部展开

x-coordinates,指定为向量。或者,指定x-使用input参数的坐标X区域函数。如果您没有指定X,然后区域中的值的索引YData随着x坐标。

XData而且YData长度必须相等。

例子:1:10

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

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

  • “汽车”—使用YData

  • “手动”—使用手动设置的值。要指定值,请设置XData属性或传递输入参数X区域函数。

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

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

请注意

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

例子:“x”

y-coordinates,指定为向量。或者,指定y-使用input参数的坐标Y区域函数。

XData而且YData长度必须相等。

例子:1:10

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

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

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

请注意

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

例子:“y”

传说

全部展开

图例标签,指定为字符向量或字符串标量。方法时,图例才会显示传说命令。如果不指定文本,则传说使用表单设置标签“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在执行处理回调队列的命令时确定回调中断行为。这些命令包括drawnow数字uifiguregetframe等待,暂停

如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后再执行中断回调。

如果正在运行的回调包含这些命令之一,则可中断属性决定是否发生中断:

  • 如果的值可中断“关闭”,则不发生中断。相反,BusyAction属性确定中断回调是被丢弃还是添加到回调队列。

  • 如果的值可中断“上”,则中断。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB继续执行正在运行的回调。

请注意

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

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

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

  • 如果中断回调属于计时器对象,则回调函数将根据调度执行,而不管可中断属性值。

请注意

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

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

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

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

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

在这些条件下,BusyAction拥有中断回调的对象的属性决定了MATLAB如何处理中断回调。的可能值BusyAction属性:

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

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

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

  • “可见”-仅在可见时捕获鼠标单击。的可见属性必须设置为“上”.的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数组。例如,您可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

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

版本历史

R2006a之前介绍

全部展开