Main Content
坐标区的外观和行为
全页展开
Axes
属性控制 Axes
对象的外观和行为。通过更改属性值,您可以修改坐标区的特定方面。使用圆点表示法查询和设置属性。
ax = gca;c = ax.Color;ax.Color = 'blue';
字体
全部展开
FontSize
— 字体大小
数值标量
字体大小,指定为数值标量。字体大小会影响标题、轴标签和刻度标签。还会影响与坐标区关联的任何图例或颜色栏。默认字体大小取决于具体操作系统和区域设置。默认情况下,字体大小以磅为单位进行测量。要更改单位,请设置 FontUnits
属性。
MATLAB 会自动将某些文本缩放为坐标区字体大小的百分比。
标题和轴标签 - 默认情况下为坐标区字体大小的 110%。要控制缩放比例,请使用
TitleFontSizeMultiplier
和LabelFontSizeMultiplier
属性。图例和颜色栏 - 默认情况下为坐标区字体大小的 90%。要指定不同的字体大小,请设置
Legend
或Colorbar
对象的FontSize
属性。
示例: ax.FontSize = 12
FontSizeMode
— 字体大小的选择模式
'auto'
(默认) | 'manual'
字体大小的选择模式,指定为下列值之一:
'auto'
- 由 MATLAB 指定的字体大小。如果将坐标区的大小调整为小于默认大小,则字体大小可能会缩小以改善可读性和布局。'manual'
- 手动指定的字体大小。不随坐标区大小改变而缩放字体大小。要指定字体大小,请设置FontSize
属性。
LabelFontSizeMultiplier
— 标签字体大小的缩放因子
1.1
(默认) | 大于 0 的数值
标签字体大小的缩放因子,指定为大于 0 的数值。此缩放因子应用于 FontSize
属性的值,以确定 x 轴、y 轴和 z 轴标签的字体大小。
示例: ax.LabelFontSizeMultiplier = 1.5
TitleFontSizeMultiplier
— 标题字体大小的缩放因子
1.1
(默认) | 大于 0 的数值
标题字体大小的缩放因子,指定为大于 0 的数值。此缩放因子应用于 FontSize
属性的值,以确定标题的字体大小。
SubtitleFontWeight
— 副标题字符粗细
'normal'
(默认) | 'bold'
副标题字符粗细,指定为下列值之一:
'normal'
- 特定字体定义的默认粗细'bold'
- 字符粗细比普通的粗
刻度
全部展开
XTick
, YTick
, ZTick
— 刻度值
[]
(默认) | 由递增值组成的向量
刻度值,指定为由递增值组成的向量。如果您不希望沿坐标轴显示刻度线,请指定空向量 []
。刻度值是坐标轴上显示刻度线的位置。刻度标签是您在每个刻度线旁边看到的标签。使用 XTickLabels
、YTickLabels
和 ZTickLabels
属性指定关联的标签。
示例: ax.XTick = [2 4 6 8 10]
示例: ax.YTick = 0:10:100
也可以使用 xticks、yticks 和 zticks 函数指定刻度值。有关示例,请参阅指定坐标轴刻度值和标签。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
XTickMode
, YTickMode
, ZTickMode
— 刻度值的选择模式
'auto'
(默认) | 'manual'
刻度值的选择模式,指定为下列值之一:
'auto'
- 根据坐标轴的数据范围自动选择刻度值。'manual'
- 手动指定刻度值。要指定值,请设置XTick
、YTick
或ZTick
属性。
示例: ax.XTickMode = 'auto'
XTickLabel
, YTickLabel
, ZTickLabel
— 刻度标签
''
(默认) | 字符向量元胞数组 | 字符串数组 | 分类数组
刻度标签,指定为字符向量元胞数组、字符串数组或分类数组。如果您不希望显示刻度标签,请指定空元胞数组 {}
。如果您没有为所有刻度值指定足够多的标签,将会重复使用标签。
刻度标签支持 TeX 和 LaTeX 标记。有关详细信息,请参阅 TickLabelInterpreter 属性。
如果将此属性指定为分类数组,MATLAB 将使用数组中的值,而不是类别。
作为设置此属性的替代方法,您还可以使用 xticklabels、yticklabels 和 zticklabels 函数。有关示例,请参阅指定坐标轴刻度值和标签。
示例: ax.XTickLabel = {'Jan','Feb','Mar','Apr'}
XTickLabelMode
, YTickLabelMode
, ZTickLabelMode
— 刻度标签的选择模式
'auto'
(默认) | 'manual'
刻度标签的选择模式,指定为下列值之一:
'auto'
- 自动选择刻度标签。'manual'
- 手动指定刻度标签。要指定标签,请设置XTickLabel
、YTickLabel
或ZTickLabel
属性。
示例: ax.XTickLabelMode = 'auto'
XTickLabelRotation
, YTickLabelRotation
, ZTickLabelRotation
— 刻度标签的旋转
0
(默认) | 以度为单位的数值
刻度标签的旋转,指定为以度为单位的数值。正值将导致按逆时针旋转。负值产生顺时针旋转。
示例: ax.XTickLabelRotation = 45
示例: ax.YTickLabelRotation = 90
或者,使用 xtickangle、ytickangle 和 ztickangle 函数。
XTickLabelRotationMode
, YTickLabelRotationMode
, ZTickLabelRotationMode
— 刻度标签旋转的选择模式
'auto'
(默认) | 'manual'
刻度标签旋转的选择模式,指定为下列值之一:
'auto'
- 自动选择刻度标签旋转方式。'manual'
- 使用您指定的刻度标签旋转方式。要指定旋转,请设置XTickLabelRotation
、YTickLabelRotation
或ZTickLabelRotation
属性。
XMinorTick
, YMinorTick
, ZMinorTick
— 次刻度线
on/off 逻辑值
次刻度线,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
'on'
- 在坐标轴的主刻度线之间显示次刻度线。主刻度线的间距决定次刻度线的数目。此值是使用对数刻度的坐标轴的默认值。'off'
- 不显示次刻度线。此值是使用线性刻度的坐标轴的默认值。
示例: ax.XMinorTick = 'on'
TickDir
— 刻度线方向
'in'
(默认) | 'out'
| 'both'
| 'none'
刻度线方向,指定为下列值之一:
'in'
- 刻度线从轴线指向内部。(二维视图的默认值)'out'
- 刻度线从轴线指向外部。(三维视图的默认值)'both'
- 刻度线以轴线为中心。'none'
- 不显示任何刻度线。
TickLength
— 刻度线长度
[0.01 0.025]
(默认) | 二元素向量
刻度线长度,指定为 [2Dlength 3Dlength]
形式的二元素向量。第一个元素是二维视图中的刻度线长度,第二个元素是三维视图中的刻度线长度。指定值是以可见的 x 轴、y 轴或 z 轴中最长线条为基准进行归一化的值。
示例: ax.TickLength = [0.02 0.035]
标尺
全部展开
XLimMode
, YLimMode
, ZLimMode
— 坐标轴范围的选择模式
'auto'
(默认) | 'manual'
坐标轴范围的选择模式,指定为下列值之一:
'auto'
- 启用自动范围选择,具体范围基于所绘制数据的总跨度和XLimitMethod
、YLimitMethod
或ZLimitMethod
属性的值。'manual'
- 手动指定坐标轴范围。要指定坐标轴范围,请设置XLim
、YLim
或ZLim
属性。
示例: ax.XLimMode = 'auto'
XLimitMethod
, YLimitMethod
, ZLimitMethod
— 坐标轴范围选择方法
'tickaligned'
(默认) | 'tight'
| 'padded'
坐标轴范围选择方法,指定为下表中的一个值。表中的示例显示 XLimitMethod
属性不同值的大致外观。根据您的数据、坐标区的大小和您创建的绘图类型,结果可能会有所不同。
值 | 描述 | 示例:(XLimitMethod )。 |
---|---|---|
'tickaligned' | 通常,将坐标区框的边缘与最接近数据的刻度线对齐,但不排除任何数据。外观可能因绘制的数据类型和创建的图类型而异。 | |
'tight' | 将坐标轴范围设置为等同于数据范围,使轴框紧密围绕数据。 | |
'padded' | 使坐标区框贴合数据,每侧只留很窄的填充边距。边距的宽度大约是数据范围的 7%。 |
注意
当对应的模式属性(XLimMode
、YLimMode
或 ZLimMode
)设置为 'manual'
时,坐标轴范围方法不起作用。
XAxis
, YAxis
, ZAxis
— 轴标尺
标尺对象
轴标尺,以标尺对象的形式返回。标尺控制 x 轴、y 轴或 z 轴的外观和行为。通过访问相关的标尺并设置标尺属性,可以修改坐标轴的外观和行为。MATLAB 为每个轴创建的标尺类型取决于绘制的数据。有关 Axes
对象支持的标尺属性的列表,请参阅:
NumericRuler 属性
DatetimeRuler 属性
DurationRuler 属性
CategoricalRuler 属性
例如,通过 XAxis
属性访问 x 轴的标尺。然后,更改标尺的 Color
属性,使 x 轴的颜色为红色。同样,将 y 轴的颜色更改为绿色。
ax = gca;ax.XAxis.Color = 'r';ax.YAxis.Color = 'g';
如果 Axes
对象有两个 y 轴,则 YAxis
属性存储两个标尺对象。
XAxisLocation
— x 轴位置
'bottom'
(默认) | 'top'
| 'origin'
x 轴位置,指定为下表中的值之一。此属性仅应用于二维视图。
值 | 描述 | 结果 |
---|---|---|
'bottom' | 坐标区的底部。 例如: | |
'top' | 坐标区的顶部。 例如: | |
'origin' | 穿过原点 (0,0)。 例如: |
YAxisLocation
— y 轴位置
'left'
(默认) | 'right'
| 'origin'
y 轴位置,指定为下表中的值之一。此属性仅应用于二维视图。
值 | 描述 | 结果 |
---|---|---|
'left' | 坐标区的左侧。 例如: | |
'right' | 坐标区的右侧。 例如: | |
'origin' | 穿过原点 (0,0)。 例如: |
XColor
, YColor
, ZColor
— 轴线、刻度值和标签的颜色
[0.15 0.15 0.15]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
x、y 或 z 方向的轴线、刻度值和标签的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。您指定的颜色还会影响网格线,除非您使用 GridColor
或 MinorGridColor
属性指定网格线颜色。
对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符串标量或字符向量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
示例: ax.XColor = [1 1 0]
示例: ax.YColor = 'y'
示例: ax.ZColor = 'yellow'
示例: ax.ZColor = '#FFFF00'
XColorMode
— 用于设置 x 轴网格颜色的属性
'auto'
(默认) | 'manual'
用于设置 x 轴网格颜色的属性,指定为 'auto'
或 'manual'
。模式值仅影响 x 轴网格颜色。无论在什么模式下,x 轴线、刻度值和标签始终使用 XColor
值。
x 轴网格颜色取决于 XColorMode
属性和 GridColorMode
属性,如下表所示。
XColorMode | GridColorMode | x 轴网格颜色 |
---|---|---|
'auto' | 'auto' | GridColor 属性 |
'manual' | GridColor 属性 | |
'manual' | 'auto' | XColor 属性 |
'manual' | GridColor 属性 |
x 轴次网格颜色取决于 XColorMode
属性和 MinorGridColorMode
属性,如下表所示。
XColorMode | MinorGridColorMode | x 轴次网格颜色 |
---|---|---|
'auto' | 'auto' | MinorGridColor 属性 |
'manual' | MinorGridColor 属性 | |
'manual' | 'auto' | XColor 属性 |
'manual' | MinorGridColor 属性 |
YColorMode
— 用于设置 y 轴网格颜色的属性
'auto'
(默认) | 'manual'
用于设置 y 轴网格颜色的属性,指定为 'auto'
或 'manual'
。模式值仅影响 y 轴网格颜色。无论在什么模式下,y 轴线、刻度值和标签始终使用 YColor
值。
y 轴网格颜色取决于 YColorMode
属性和 GridColorMode
属性,如下表所示。
YColorMode | GridColorMode | y 轴网格颜色 |
---|---|---|
'auto' | 'auto' | GridColor 属性 |
'manual' | GridColor 属性 | |
'manual' | 'auto' | YColor 属性 |
'manual' | GridColor 属性 |
y 轴次网格颜色取决于 YColorMode
属性和 MinorGridColorMode
属性,如下表所示。
YColorMode | MinorGridColorMode | y 轴次网格颜色 |
---|---|---|
'auto' | 'auto' | MinorGridColor 属性 |
'manual' | MinorGridColor 属性 | |
'manual' | 'auto' | YColor 属性 |
'manual' | MinorGridColor 属性 |
ZColorMode
— 用于设置 z 轴网格颜色的属性
'auto'
(默认) | 'manual'
用于设置 z 轴网格颜色的属性,指定为 'auto'
或 'manual'
。模式值仅影响 z 轴网格颜色。无论在什么模式下,z 轴线、刻度值和标签始终使用 ZColor
值。
z 轴网格颜色取决于 ZColorMode
属性和 GridColorMode
属性,如下表所示。
ZColorMode | GridColorMode | z 轴网格颜色 |
---|---|---|
'auto' | 'auto' | GridColor 属性 |
'manual' | GridColor 属性 | |
'manual' | 'auto' | ZColor 属性 |
'manual' | GridColor 属性 |
z 轴次网格颜色取决于 ZColorMode
属性和 MinorGridColorMode
属性,如下表所示。
ZColorMode | MinorGridColorMode | z 轴次网格颜色 |
---|---|---|
'auto' | 'auto' | MinorGridColor 属性 |
'manual' | MinorGridColor 属性 | |
'manual' | 'auto' | ZColor 属性 |
'manual' | MinorGridColor 属性 |
XDir
— x 轴方向
'normal'
(默认) | 'reverse'
x 轴方向,指定为下列值之一。
值 | 描述 | 生成二维视图 | 生成三维视图 |
---|---|---|---|
'normal' | 值从左向右逐渐增加。 例如: | ||
'reverse' | 值从右向左逐渐增加。 例如: |
YDir
— y 轴方向
'normal'
(默认) | 'reverse'
y 轴方向,指定为下列值之一。
值 | 描述 | 生成二维视图 | 生成三维视图 |
---|---|---|---|
'normal' | 值从下向上(二维视图)或从前向后(三维视图)逐渐增加。 例如: | ||
'reverse' | 值从上向下(二维视图)或从后向前(三维视图)逐渐增加。 例如: |
ZDir
— z 轴方向
'normal'
(默认) | 'reverse'
z 轴方向,指定为下列值之一。
值 | 描述 | 生成三维视图 |
---|---|---|
'normal' | 值按从内向外(二维视图)或从下向上(三维视图)逐渐增加。 例如: | |
'reverse' | 值按从外向内(二维视图)或从上向下(三维视图)逐渐增加。 例如: |
网格
全部展开
XGrid
, YGrid
, ZGrid
— 网格线
'off'
(默认) | on/off 逻辑值
网格线,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
'on'
- 坐标轴正交的网格线,例如,沿着常量 x、y 或 z 值对应的线条。'off'
- 不显示网格线。
还可以使用 grid on
或 grid off
命令将所有三个属性分别设置为 'on'
或 'off'
。有关详细信息,请参阅 grid。
示例: ax.XGrid = 'on'
GridLineWidth
— 网格线宽度
0.5
(默认) | 正数
自 R2023a 起
网格线宽度,指定为正数。设置此属性或 MinorGridLineWidth 属性可独立于框轮廓和刻度线控制网格线的粗细。
示例
创建向量 x
和 y
,并对其绘图。通过调用 grid on
显示坐标区中的网格线。通过将坐标区的 LineWidth
属性设置为 1.5
,增大网格线、框轮廓和刻度线的粗细。
x = linspace(0,10);y = sin(x);plot(x,y)grid onax = gca;ax.LineWidth = 1.5;
通过将网格线宽度设置为 0.5
使网格线变细。
ax.GridLineWidth = 0.5;
GridLineWidthMode
— 如何设置网格线宽度
"auto"
(默认) | "manual"
自 R2023a 起
如何设置网格线宽度,指定为以下值之一:
"auto"
- 将GridLineWidth
属性设置为与LineWidth
属性相同的值。"manual"
- 保留GridLineWidth
属性的当前值。
当您将 GridLineWidth
属性显式设置为一个值时,MATLAB 会将此属性设置为 "manual"
。
GridColor
— 网格线的颜色
[0.15 0.15 0.15]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
网格线的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符串标量或字符向量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
要为坐标区框轮廓设置颜色,请使用 XColor
、YColor
和 ZColor
属性。
要显示网格线,请使用 grid on
命令或将 XGrid
、YGrid
或 ZGrid
属性设置为 'on'
。
示例: ax.GridColor = [0 0 1]
示例: ax.GridColor = 'b'
示例: ax.GridColor = 'blue'
示例: ax.GridColor = '#0000FF'
GridColorMode
— 用于设置网格颜色的属性
'auto'
(默认) | 'manual'
用于设置网格颜色的属性,指定为下列值之一:
'auto'
- 检查XColorMode
、YColorMode
和ZColorMode
属性的值,以确定 x、y 和 z 方向的网格线颜色。'manual'
- 使用GridColor
设置所有方向的网格线颜色。
XMinorGrid
, YMinorGrid
, ZMinorGrid
— 次网格线
'off'
(默认) | on/off 逻辑值
次网格线,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
'on'
- 显示与轴的次刻度线对齐的网格线。不必启用次刻度即可显示次网格线。'off'
- 不显示网格线。
或者使用 grid minor
命令切换次网格线的可见性。
示例: ax.XMinorGrid = 'on'
MinorGridLineStyle
— 次网格线的线型
':'
(默认) | '-'
| '--'
| '-.'
| 'none'
次网格线的线型,指定为下表中显示的线型之一。
线型 | 描述 | 表示的线条 |
---|---|---|
"-" | 实线 | |
"--" | 虚线 | |
":" | 点线 | |
"-." | 点划线 | |
"none" | 无线条 | 无线条 |
要显示次网格线,请使用 grid minor
命令或将 XMinorGrid
、YMinorGrid
或 ZMinorGrid
属性设置为 'on'
。
示例: ax.MinorGridLineStyle = '-.'
MinorGridLineWidth
— 次网格线宽度
0.5
(默认) | 正数
自 R2023a 起
次网格线宽度,指定为正数。设置此属性或 GridLineWidth 属性可独立于框轮廓和刻度线控制网格线的粗细。
提示
要查看次网格线,请将
XMinorGrid
、YMinorGrid
或ZMinorGrid
属性设置为"on"
。当您设置
GridLineWidth
属性时,MATLAB 会同时将MinorGridLineWidth
属性设置为相同的值。要避免更改MinorGridLineWidth
属性,请在设置GridLineWidth
属性之前,将MinorGridLineWidthMode
属性设置为"manual"
。
MinorGridLineWidthMode
— 如何设置次网格线宽度
"auto"
(默认) | "manual"
自 R2023a 起
如何设置次网格线宽度,指定为以下值之一:
"auto"
- 将MinorGridLineWidth
属性设置为与GridLineWidth
属性相同的值。"manual"
- 保留MinorGridLineWidth
属性的当前值。
当您将 MinorGridLineWidth
属性显式设置为一个值时,MATLAB 会将此属性设置为 "manual"
。
MinorGridColor
— 次网格线的颜色
[0.1 0.1 0.1]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
次网格线的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符串标量或字符向量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
要显示次网格线,请使用 grid minor
命令或将 XMinorGrid
、YMinorGrid
或 ZMinorGrid
属性设置为 'on'
。
示例: ax.MinorGridColor = [0 0 1]
示例: ax.MinorGridColor = 'b'
示例: ax.MinorGridColor = 'blue'
示例: ax.MinorGridColor = '#0000FF'
MinorGridColorMode
— 用于设置次网格颜色的属性
'auto'
(默认) | 'manual'
用于设置次网格颜色的属性,指定为下列值之一:
'auto'
- 检查XColorMode
、YColorMode
和ZColorMode
属性的值,以确定 x、y 和 z 方向的网格线颜色。'manual'
- 使用MinorGridColor
设置所有方向的次网格线颜色。
标签
全部展开
Title
— 标题的文本对象
文本对象
坐标区标题的文本对象。要添加标题,请设置文本对象的 String
属性。要更改标题外观,例如字体样式或字体颜色,请设置其他属性。有关完整列表,请参阅 Text 属性。
ax = gca;ax.Title.String = 'My Title';ax.Title.FontWeight = 'normal';
也可以使用 title 函数添加标题并控制外观。
title('My Title','FontWeight','normal')
注意
此文本对象不包含在坐标区的 Children
属性中,它不能由 findobj 返回,也不使用为文本对象定义的默认值。
Subtitle
— 副标题的文本对象
文本对象
坐标区副标题的文本对象。要添加副标题,请设置文本对象的 String
属性。要更改其外观,如字体角度,请设置其他属性。有关完整列表,请参阅 Text 属性。
ax = gca;ax.Subtitle.String = 'An Insightful Subtitle';ax.Subtitle.FontAngle = 'italic';
也可以使用 subtitle 函数添加副标题并控制外观。
subtitle('An Insightful Subtitle','FontAngle','italic')
或者使用 title 函数,指定两个字符向量输入参量和两个输出参量。然后设置该函数返回的第二个文本对象的属性。
[t,s] = title('Clever Title','An Insightful Subtitle');s.FontAngle = 'italic';
注意
此文本对象不包含在坐标区的 Children
属性中,它不能由 findobj 返回,也不使用为文本对象定义的默认值。
TitleHorizontalAlignment
— 标题和副标题水平对齐
'center'
(默认) | 'left'
| 'right'
标题和副标题与图框水平对齐,指定为下表中的值之一。
TitleHorizontalAlignment 值 | 描述 | 外观 |
---|---|---|
'center' | 标题和副标题位于图框上方的居中位置。 | |
'left' | 标题和副标题与图框的左侧对齐。 | |
'right' | 标题和副标题与图框的右侧对齐。 |
XLabel
, YLabel
, ZLabel
— 坐标轴标签的文本对象
文本对象
轴标签的文本对象。要添加轴标签,请设置文本对象的 String
属性。要更改标签外观,例如字号,请设置其他属性。有关完整列表,请参阅 Text 属性。
ax = gca;ax.YLabel.String = 'My y-Axis Label';ax.YLabel.FontSize = 12;
也可以使用 xlabel、ylabel 和 zlabel 函数添加轴标签并控制外观。
ylabel('My y-Axis Label','FontSize',12)
注意
这些文本对象不包含在坐标区的 Children
属性中,它们不能由 findobj 返回,也不使用为文本对象定义的默认值。
Legend
— 与坐标区关联的图例
empty GraphicsPlaceholder
(默认) | Legend
对象
此 属性 为只读。
与 Axes
对象关联的图例,指定为 Legend
对象。要向坐标区中添加图例,请使用 legend 函数。然后,您可以使用此属性修改图例。有关完整的属性列表,请参阅 Legend 属性。
plot(rand(3))legend({'Line 1','Line 2','Line 3'},'FontSize',12)ax = gca;ax.Legend.TextColor = 'red';
还可以使用此属性确定坐标区是否包含图例。
ax = gca;lgd = ax.Legendif ~isempty(lgd) disp('Legend Exists')end
多个绘图
全部展开
LineStyleCyclingMethod
— 如何循环使用线型
"aftercolor"
(默认) | "beforecolor"
| "withcolor"
自 R2023a 起
当坐标区中有多条线时如何循环使用线型,指定为下表中的值之一。
下表中的示例是使用 ColorOrder
属性中的默认颜色和 LineStyleOrder
属性中的三种线型 (["-","-o","--"]
) 创建的。
值 | 描述 | 示例 |
---|---|---|
| 先循环使用 ColorOrder 的颜色,再循环使用 LineStyleOrder 的线型。 | |
"beforecolor" | 先循环使用 | |
"withcolor" | 循环使用 |
NextSeriesIndex
— 下一个对象的 SeriesIndex
值
整数
此 属性 为只读。
添加到坐标区的下一个绘图对象的 SeriesIndex
值,以大于或等于 0
的整数形式返回。当您要跟踪对象如何循环使用颜色和线型时,此属性非常有用。此属性维护坐标区中具有数值 SeriesIndex
属性值的对象的计数。MATLAB 使用它为每个新对象分配 SeriesIndex
值。计数在创建坐标区时从 1
开始,每增加一个对象,计数就会增加 1
。因此,该计数通常是 n+1,其中 n 是坐标区中对象的数量。
如果您手动更改 ColorOrderIndex
或坐标区上的 LineStyleOrderIndex
属性,NextSeriesIndex
属性的值将更改为 0
。因此,当您更改坐标区上的 ColorOrder
或 LineStyleOrder
属性时,具有 SeriesIndex
属性的对象不再自动更新。
颜色图和透明度图
全部展开
Colormap
— 颜色图
parula (默认) | 由 RGB 三元组组成的 m
×3
数组
颜色图,指定为由 RGB(红色、绿色、蓝色)三元组组成的 m
×3
数组,这些三元组定义 m
种单独的颜色。
示例: ax.Colormap = [1 0 1; 0 0 1; 1 1 0]
将颜色图设置为三种颜色:品红色、蓝色和黄色。
MATLAB 按行号访问这些颜色。
也可以使用 colormap 函数更改颜色图。
ColorScale
— 颜色图的刻度
'linear'
(默认) | 'log'
颜色图的刻度,指定为下列值之一:
'linear'
- 线性刻度。颜色栏上的刻度值也使用线性刻度。'log'
- 对数刻度。颜色栏上的刻度值也使用对数刻度。
CLim
— 颜色范围
[0 1]
(默认) | [cmin cmax]
形式的二元素向量
坐标区中使用颜色图的对象的颜色范围,指定为 [cmin cmax]
形式的二元素向量。此属性用来确定数据值如何映射到颜色图中的颜色,其中:
cmin
指定映射到颜色图中的第一个颜色的数据值。cmax
指定映射到颜色图中的最后一个颜色的数据值。
Axes
对象根据颜色图中 cmin
和 cmax
所规定的范围进行数据值插值。此范围外的值使用第一个或最后一个颜色(取最接近的值)。
Alphamap
— 透明度图
由从 0
到 1
的 64 个值组成的数组 (默认) | 由从 0
到 1
的有限 alpha 值组成的数组
透明度图,指定为从 0
到 1
线性递增的有限 alpha 值组成的数组。数组大小可以是 m×1 或 1×m。MATLAB 按 alpha 值在数组中的索引访问来它们。Alphamap 可以为任意长度。
AlphaScale
— 透明度图的刻度
'linear'
(默认) | 'log'
透明度图的刻度,指定为下列值之一:
'linear'
- 线性刻度'log'
- 对数刻度
ALim
— alpha 范围
[0 1]
(默认) | [amin amax]
形式的二元素向量
alpha 范围,指定为 [amin amax]
形式的二元素向量。此属性影响图形对象(如曲面、图像和补片对象)的 AlphaData
值。此属性决定 AlphaData
值如何映射到图窗 alpha 映射,其中:
amin
指定映射到图窗 alpha 映射的第一个 alpha 值的数据值。amax
指定映射到图窗 alpha 映射的最后一个 alpha 值的数据值。
Axes
对象根据图窗的 alpha 映射中 amin
和 amax
所规定的范围进行数据值插值。此范围外的值使用第一个或最后一个 alpha 映射值(取最接近的值)。
图窗的 Alphamap 属性包含 alpha 映射。有关详细信息,请参阅 alpha 函数。
框样式
全部展开
Color
— 背景色
[1 1 1]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
背景颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符串标量或字符向量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
示例: ax.Color = [0 0 1];
示例: ax.Color = 'b';
示例: ax.Color = 'blue';
示例: ax.Color = '#0000FF';
LineWidth
— 线条宽度
0.5
(默认) | 正数值
坐标区轮廓、刻度线和网格线的线宽,指定为正数值(以磅为单位)。一磅等于 1/72 英寸。
示例: ax.LineWidth = 1.5
Box
— 框轮廓
'off'
(默认) | on/off 逻辑值
框轮廓,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
值 | 描述 | 二维结果 | 三维结果 |
---|---|---|---|
'on' | 显示坐标区周围的框轮廓。对于三维视图,可以使用 例如: | ||
'off' | 不显示坐标区周围的框轮廓。 例如: |
XColor
、YColor
和 ZColor
属性控制轮廓的颜色。
示例: ax.Box = 'on'
BoxStyle
— 框轮廓样式
'back'
(默认) | 'full'
框轮廓样式,指定为 'back'
或 'full'
。此属性仅影响三维视图。
值 | 描述 | 结果 |
---|---|---|
'back' | 画出三维框的背板轮廓。 例如: | |
'full' | 画出整个三维框的轮廓。 例如: |
Clipping
— 在坐标区范围内裁剪对象
'on'
(默认) | on/off 逻辑值
按照坐标区范围裁剪对象,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
Axes
对象内某个对象的裁剪行为由 Axes
对象的 Clipping
属性和该具体对象的 Clipping
属性共同决定。Axes
对象的属性值具有以下作用:
'on'
- 使坐标区内的每个对象基于其Clipping
属性值控制自身的裁剪行为。'off'
- 禁用坐标区内所有对象的裁剪,而不管各个对象的Clipping
属性值如何设置。对象的某些部分可能会显示在坐标区范围之外。例如,如果创建一个绘图,使用hold on
命令冻结轴缩放,然后添加一个大于原始绘图的绘图,则绘图的某些部分可能会显示在范围之外。
下表列出了 Clipping
属性值的不同组合结果。
坐标区对象的裁剪属性 | 单个对象的裁剪属性 | 结果 |
---|---|---|
'on' | 'on' | 裁剪单个对象。其他对象可能会被裁剪,也可能不会。 |
'on' | 'off' | 不裁剪单个对象。其他对象可能会被裁剪,也可能不会。 |
'off' | 'on' | 所有对象都不裁剪。 |
'off' | 'off' | 所有对象都不裁剪。 |
ClippingStyle
— 裁剪边界
'3dbox'
(默认) | 'rectangle'
裁剪边界,指定为下表中的值之一。如果绘图包含标记,则只要数据点位于坐标区范围内,MATLAB 就会绘制整个标记。
如果 Clipping
属性设置为 'off'
,则 ClippingStyle
属性无效。
值 | 描述 | 边界区域图示 |
---|---|---|
'3dbox' | 按照坐标轴范围定义的坐标区框的六条边对绘制对象进行裁剪。 粗线可能会显示在坐标区范围之外。 | |
'rectangle' | 在任何给定视图中按照包围坐标区的矩形边界对绘制对象进行裁剪。 在坐标区范围处裁剪粗线。 |
AmbientLightColor
— 背景光源颜色
[1 1 1]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
背景光颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。背景光是一种无向光,均匀地照射在坐标区内的所有对象上。要添加光源,请使用 light 函数。
对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符串标量或字符向量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
示例: ax.AmbientLightColor = [1 0 1]
示例: ax.AmbientLightColor = 'm'
示例: ax.AmbientLightColor = 'magenta'
示例: ax.AmbientLightColor = '#FF00FF'
位置
全部展开
InnerPosition
— 内界大小和位置
[0.1300 0.1100 0.7750 0.8150]
(默认) | 四元素向量
内部尺寸和位置,指定为 [left bottom width height]
形式的四元素向量。此属性等同于 Position
属性。
注意
当查询具有约束纵横比的坐标区(如方形坐标区或包含图像的坐标区)的内部位置时,可考虑使用 tightPosition 函数以获得更高的准确度。(从 R2022b 开始)
当父容器为
TiledChartLayout
时,设置此属性不起作用
TightInset
— 文本标签的边距
[left bottom right top]
形式的四元素向量
此 属性 为只读。
文本标签的边距,以 [left bottom right top]
形式的四元素向量返回。默认情况下,MATLAB 按照归一化的容器单位来测量值。要更改单位,请设置 Units
属性。
这些元素定义 Position
属性的边界与周围文本之间的距离。将 Position
值与 TightInset
值结合使用可定义包围坐标区和周围文本的最紧凑的边界框。
下面的图显示由 OuterPosition
值(蓝色)、Position
值(红色)以及由 TightInset
值(品红色)外扩的 Position
定义的区域。
二维坐标区视图 | 三维坐标区视图 |
---|---|
有关详细信息,请参阅控制坐标区布局。
PositionConstraint
— 保持不变的位置
"outerposition"
| "innerposition"
在增加、删除或更改装饰元素时保持不变的位置属性,指定为下列值之一:
"outerposition"
- 在添加、删除或更改装饰元素(例如标题或轴标签)时,OuterPosition
属性保持不变。如需任何位置调整,MATLAB 会调整InnerPosition
属性。"innerposition"
- 在添加、删除或更改装饰元素(例如标题或轴标签)时,InnerPosition
属性保持不变。如需任何位置调整,MATLAB 会调整OuterPosition
属性。
注意
当父容器为 TiledChartLayout
对象时,设置此属性不起作用。
DataAspectRatio
— 数据单元的相对长度
[1 1 1]
(默认) | [dx dy dz]
形式的三元素向量
数据单位沿每个坐标轴的相对长度,指定为 [dx dy dz]
形式的三元素向量。此向量定义相对的 x、y 和 z 数据缩放因子。例如,若将该属性指定为 [1 2 1]
,会将 x 方向中的一个数据单位长度设置为等同于 y 方向中的两个数据单位长度和 z 方向中的一个数据单位长度。
也可以使用 daspect 函数更改数据纵横比。
示例: ax.DataAspectRatio = [1 1 1]
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
DataAspectRatioMode
— 数据纵横比模式
'auto'
(默认) | 'manual'
数据纵横比模式,指定为下列值之一:
'auto'
- 自动选择能够充分利用可用空间的值。如果PlotBoxAspectRatioMode
和CameraViewAngleMode
也设置为'auto'
,将启用“伸展填充”行为。伸展坐标区,使其填满Position
属性定义的可用空间。'manual'
- 禁用“伸展填充”行为并使用手动指定的数据纵横比。要指定值,请设置DataAspectRatio
属性。
PlotBoxAspectRatio
— 每个坐标轴的相对长度
[1 1 1]
(默认) | [px py pz]
形式的三元素向量
每个坐标轴的相对长度,指定为 [px py pz]
形式的三元素向量,三个元素分别定义 x 轴、y 轴和 z 轴的相对缩放因子。图框是包含坐标轴范围定义的轴数据区域的框。
也可以使用 pbaspect 函数更改图框纵横比。
如果您指定了坐标轴范围、数据纵横比和图框纵横比,MATLAB 将忽略图框纵横比,而遵守坐标轴范围和数据纵横比。
示例: ax.PlotBoxAspectRatio = [1 0.75 0.75]
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
PlotBoxAspectRatioMode
— PlotBoxAspectRatio
的选择模式
'auto'
(默认) | 'manual'
PlotBoxAspectRatio
属性的选择模式,指定为下列值之一:
'auto'
- 自动选择能够充分利用可用空间的值。如果DataAspectRatioMode
和CameraViewAngleMode
也设置为'auto'
,将启用“伸展填充”行为。伸展Axes
对象,使其填满Position
属性定义的可用空间。'manual'
- 禁用“伸展填充”行为并使用手动指定的图框纵横比。要指定值,请设置PlotBoxAspectRatio
属性。
Layout
— 布局选项
空 LayoutOptions
数组 (默认) | TiledChartLayoutOptions
对象 | GridLayoutOptions
对象
布局选项,指定为 TiledChartLayoutOptions
或 GridLayoutOptions
对象。当坐标区对象位于分块图布局或网格布局中时,此属性非常有用。
要在分块图布局的网格中定位坐标区,请设置 TiledChartLayoutOptions
对象的 Tile
和 TileSpan
属性。例如,假设有一个 3×3 分块图布局。布局的中心有一个包含若干图块的网格,外边缘四周各有一个图块。实际上,该网格不可见,外侧图块也不占用空间,除非您用坐标区或图填充它们。
以下代码将坐标区 ax
放置在网格的第三个图块中。
ax.Layout.Tile = 3;
要使坐标区占据多个图块,请将 TileSpan
属性指定为二元素向量。例如,此坐标区占据了 2
行和 3
列的图块。
ax.Layout.TileSpan = [2 3];
要将坐标区放置在四周的某个图块中,请将 Tile
属性指定为 'north'
、'south'
、'east'
或 'west'
。例如,将值设置为 'east'
会将坐标区放置在网格右侧的图块中。
ax.Layout.Tile = 'east';
要将坐标区放入 App 内的布局中,请将此属性指定为 GridLayoutOptions
对象。有关在 App 中使用网格布局的详细信息,请参阅 uigridlayout。
如果此坐标区不是分块图布局或网格布局的子级(例如,如果它是图窗或面板的子级),则此属性为空且不起作用。
视图
全部展开
View
— 视图的方位角和仰角
[0 90]
(默认) | [azimuth elevation]
形式的二元素向量
视图的方位角和仰角,指定为以度为单位定义的 [azimuth elevation]
形式的二元素向量。也可以使用 view 函数设置视图。
注意
设置方位角和仰角可能会重置其他与相机相关的属性。为了获得最佳效果,请在设置其他与相机相关的属性之前设置方位角和仰角。
示例: ax.View = [45 45]
Projection
— 二维屏幕上的投影类型
'orthographic'
(默认) | 'perspective'
二维屏幕上的投影类型,指定为下列值之一:
'orthographic'
- 保持图形对象的正确相对维度(就给定点到观察者之间的距离而言),并在屏幕上根据平行数据绘制平行线条。'perspective'
- 使用前缩透视法,这可以让您在三维对象的二维表示形式中表现景深。透视投影不会保留对象的相对维度。它改为显示较远的线段短于较近的等长线段。按数据平行的线条在屏幕上可能显示为不平行。
CameraPosition
— 相机位置
[x y z]
形式的三元素向量
相机位置或视点,指定为 [x y z]
形式的三元素向量。此向量定义相机位置(即您观察坐标区的点)的坐标区坐标。相机沿视图轴指定方向,该轴是一条连接相机位置和相机目标的直线。有关说明,请参阅相机图形术语。
如果 Projection 属性设置为 'perspective'
,则当您更改 CameraPosition
设置时,透视量也会更改。
也可以使用 campos 函数设置相机位置。
示例: ax.CameraPosition = [0.5 0.5 9]
数据类型: single
| double
CameraPositionMode
— CameraPosition
的选择模式
'auto'
(默认) | 'manual'
CameraPosition
属性的选择模式,指定为下列值之一:
'auto'
- 沿观察轴自动设置CameraPosition
。计算位置,使相机沿当前视图(view 函数返回的视图)指定的方位角和仰角与目标保持固定的距离。诸如 rotate3d、zoom 和 pan 之类的函数会将此模式更改为'auto'
以执行其操作。'manual'
- 手动指定值。要指定值,请设置CameraPosition
属性。
CameraTarget
— 相机目标点
[x y z]
形式的三元素向量
相机目标点,指定为 [x y z]
形式的三元素向量。此向量定义点的轴坐标。相机沿视图轴指定方向,该轴是一条连接相机位置和相机目标的直线。有关说明,请参阅相机图形术语。
也可以使用 camtarget 函数设置相机目标。
示例: ax.CameraTarget = [0.5 0.5 0.5]
数据类型: single
| double
CameraTargetMode
— CameraTarget
的选择模式
'auto'
(默认) | 'manual'
CameraTarget
属性的选择模式,指定为下列值之一:
'auto'
- 将相机目标置于轴图框矩心。'manual'
- 使用手动指定的相机目标值。要指定值,请设置CameraTarget
属性。
CameraUpVector
— 定义向上方向的向量
[x y z]
形式的三元素方向向量
定义向上方向的向量,指定为 [x y z]
形式的三元素方向向量。对于二维视图,默认值为 [0 1 0]
。对于三维视图,默认值为 [0 0 1]
。有关说明,请参阅相机图形术语。
也可以使用 camup 函数设置向上的方向。
示例: ax.CameraUpVector = [sin(45) cos(45) 1]
CameraUpVectorMode
— CameraUpVector
的选择模式
'auto'
(默认) | 'manual'
CameraUpVector
属性的选择模式,指定为下列值之一:
'auto'
- 对于三维视图,自动将值设置为[0 0 1]
,使 z 轴正方向朝上。对于二维视图,将值设置为[0 1 0]
,使 y 轴正方向朝上。'manual'
- 手动指定定义向上方向的向量。要指定值,请设置 CameraUpVector 属性。
CameraViewAngle
— 视野
6.6086
(默认) | 范围 [0,180) 中的标量角
视野,指定为大于 0 且小于或等于 180 的标量角。更改相机视角会影响坐标区中显示的图形对象的大小,但不会影响透视变形度。角度越大,视野越大,而场景中显示的对象就越小。有关说明,请参阅相机图形术语。
示例: ax.CameraViewAngle = 15
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
CameraViewAngleMode
— CameraViewAngle
的选择模式
'auto'
(默认) | 'manual'
CameraViewAngle
属性的选择模式,指定为下列值之一:
'auto'
- 自动选择能够捕获整个场景的最小角度作为视野(最高可达 180 度)。'manual'
- 手动指定视野。要指定值,请设置 CameraViewAngle 属性。
交互性
全部展开
Toolbar
— 数据探索工具栏
AxesToolbar
对象 (默认)
数据探索工具栏,它是一个 AxesToolbar
对象。将鼠标悬停在坐标区上时,工具栏会显示在坐标区的右上角。
工具栏按钮取决于坐标区的内容,但通常包括缩放、平移、旋转、数据提示、数据刷亮和还原原始视图。您可以使用 axtoolbar 和 axtoolbarbtn 函数自定义工具栏按钮。
如果您不希望在将鼠标悬停在坐标区上时显示工具栏,请将 AxesToolbar
对象的 Visible
属性设置为 'off'
。
ax = gca;ax.Toolbar.Visible = 'off';
有关详细信息,请参阅 AxesToolbar 属性。
Interactions
— 交互
由交互对象组成的数组 | []
交互,指定为由交互对象组成的数组或空数组。可以通过手势在图中使用您指定的交互。您不必选择任何坐标区工具栏按钮即可使用它们。例如,可以通过 panInteraction 对象在图中拖动以进行平移。有关交互对象的列表,请参阅对图的交互进行控制。
默认的交互集取决于您所显示的图的类型。您可以将默认集替换为新的交互集,但不能访问或修改默认集中的任何交互。例如,以下代码用 panInteraction 和 zoomInteraction 对象替换默认交互集。
ax = gca;ax.Interactions = [panInteraction zoomInteraction];
要从坐标区中删除所有交互,请将此属性设置为空数组。要暂时禁用当前交互集,请调用 disableDefaultInteractivity 函数。您可以通过调用 enableDefaultInteractivity 函数来重新启用它们。
注意
findobj 或 findall 不会返回交互对象,copyobj 也不会复制交互对象。
Visible
— 可见性状态
'on'
(默认) | on/off 逻辑值
可见性状态,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
'on'
- 显示坐标区及其子级。'off'
- 隐藏坐标区而不删除它。您仍然可以访问不可见坐标区对象的属性。
注意
当 Visible
属性为 'off'
时,坐标区对象不可见,但线条等子对象仍然可见。
CurrentPoint
— 鼠标指针的位置
2×3 数组
此 属性 为只读。
鼠标指针的位置,以 2×3 数组形式返回。CurrentPoint
属性包含鼠标指针相对于坐标区的 (x,y,z) 坐标。返回的数组采用如下形式:
[xfront yfront zfront xback yback zback]
这两点指示最后一次鼠标点击的位置。但是,如果图窗定义了 WindowButtonMotionFcn
回调,则这些点指示鼠标指针最后所在的位置。图窗还有一个 CurrentPoint 属性。
由于坐标区立方体的形状可能有所不同,因此使用透视投影时当前点的值可能不同于正交投影中的同一点。
正交投影
使用正交投影时,值取决于点击的位置在坐标区内还是坐标区外。
如果点击位置在坐标区内,则这两个点位于与屏幕平面垂直并穿过指针的直线上。坐标表示这条直线与坐标区立方体(由轴 x、y 和 z 的范围定义)的前平面和后平面相交的点。第一行表示距离相机位置最近的点。第二行表示距相机位置最远的点。这适用于二维和三维视图。
如果点击位置在坐标区外但在图窗内,则点位于穿过指针并垂直于相机目标和相机位置平面的直线上。第一行是相机位置平面上的点。第二行是相机目标平面上的点。
透视投影
在透视投影中,在 Axes
对象外点击将返回前点作为当前相机位置。只有后点的坐标才会更新,即相机位置与鼠标指针连线的延长线与相机目标的交点的坐标。
回调
全部展开
回调执行控件
全部展开
父级/子级
全部展开
Parent
— 父容器
Figure
对象 | Panel
对象 | Tab
对象 | TiledChartLayout
对象 | GridLayout
对象
父容器,指定为 Figure
、Panel
、Tab
、TiledChartLayout
或 GridLayout
对象。
标识符
全部展开
Type
— 图形对象的类型
'axes'
此 属性 为只读。
图形对象的类型,以 'axes'
形式返回。
版本历史记录
在 R2006a 之前推出
全部展开
R2023a: 使用 LineStyleCyclingMethod
属性控制线型的循环
使用 LineStyleCyclingMethod
属性控制如何在坐标区中区分不同的线条。
R2023a: 使用 GridLineWidth
和 MinorGridLineWidth
属性指定网格线的粗细
通过设置坐标区的 GridLineWidth
和 MinorGridLineWidth
属性,独立于框轮廓和刻度线更改网格线的粗细。在 R2023a 之前,坐标区的 LineWidth
属性是控制网格线宽度的唯一属性。但是,该属性同时控制网格线、框轮廓和刻度线。现在,您可以单独控制网格线的粗细。
R2022a: FontSmoothing
属性在以后的版本中将不起作用
FontSmoothing
属性在以后的版本中将不起作用。无论该属性的值如何,都将启用字体平滑处理。
R2022a: 使用 XTickLabelRotationMode
、YTickLabelRotationMode
和 ZTickLabelRotationMode
属性控制刻度标签旋转
现在,您可以通过设置 XTickLabelRotationMode
、YTickLabelRotationMode
或 ZTickLabelRotationMode
属性来控制刻度标签旋转的选择模式。
R2021b: 通过将 TickDir
属性设置为 "none"
可删除刻度线
通过将 TickDir
属性设置为 "none"
可删除坐标区上的所有刻度线。
R2021a: 使用 XLimitMethod
、YLimitMethod
和 ZLimitMethod
属性控制轴范围
通过在坐标区上设置 XLimitMethod
、YLimitMethod
或 ZLimitMethod
,控制绘图的坐标轴范围。
R2020b: 使用 TitleHorizontalAlignment
属性控制绘图标题的对齐方式
通过将坐标区的 TitleHorizontalAlignment
属性设置为 "left"
、"right"
或 "center"
,可以控制绘图标题的对齐方式。
R2020b: 使用 Subtitle
和 SubtitleFontWeight
属性创建副标题并设置其样式
通过设置 Subtitle
属性或调用 subtitle 函数向绘图添加副标题。要控制副标题的外观,请设置 SubtitleFontWeight
属性。
R2020a: 使用 PositionConstraint
属性保留内部或外部位置
设置 Axes
对象的 PositionConstraint
属性,以便在添加或修改标题和轴标签等装饰元素时控制图框周围的空间。
R2020a: 不推荐使用 UIContextMenu
属性
不推荐设置或获取 UIContextMenu
属性。请改为使用 ContextMenu
属性,该属性接受相同类型的输入,其行为方式与 UIContextMenu
属性相同。
没有删除 UIContextMenu
属性的计划,但当您对 Axes
对象调用 set
、get
或 properties
函数时,该属性不再列出。
R2019b: 使用 Layout
属性在分块图布局中定位坐标区
使用 Layout
属性在分块图布局中定位 Axes
对象。
R2019a: 使用 Interactions
属性自定义图交互
通过设置坐标区的 Interactions
属性,可以创建一组自定义的图交互。这些交互内置于坐标区中,无需选择坐标区工具栏中的任何按钮即可使用。根据坐标区的内容,某些类型的交互默认处于启用状态。
R2018a: 使用 Toolbar
属性向坐标区添加工具栏
使用 Toolbar
属性将工具栏添加到坐标区的右上角,以便快速访问数据探索工具。
另请参阅
axes | axis | gca | cla | box | grid
主题
- 访问属性值
- 图形对象属性
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 简体中文
- English
- 日本 (日本語)
- 한국 (한국어)
Contact your local office