坐标区的外观和行为 - MATLAB - MathWorks 中国 (2024)

Table of Contents
字体 FontSize — 字体大小 数值标量 FontSizeMode — 字体大小的选择模式 'auto' (默认) | 'manual' LabelFontSizeMultiplier — 标签字体大小的缩放因子 1.1 (默认) | 大于 0 的数值 TitleFontSizeMultiplier — 标题字体大小的缩放因子 1.1 (默认) | 大于 0 的数值 SubtitleFontWeight — 副标题字符粗细 'normal' (默认) | 'bold' 刻度 XTick, YTick, ZTick — 刻度值 [] (默认) | 由递增值组成的向量 XTickMode, YTickMode, ZTickMode — 刻度值的选择模式 'auto' (默认) | 'manual' XTickLabel, YTickLabel, ZTickLabel — 刻度标签 '' (默认) | 字符向量元胞数组 | 字符串数组 | 分类数组 XTickLabelMode, YTickLabelMode, ZTickLabelMode — 刻度标签的选择模式 'auto' (默认) | 'manual' XTickLabelRotation, YTickLabelRotation, ZTickLabelRotation — 刻度标签的旋转 0 (默认) | 以度为单位的数值 XTickLabelRotationMode, YTickLabelRotationMode, ZTickLabelRotationMode — 刻度标签旋转的选择模式 'auto' (默认) | 'manual' XMinorTick, YMinorTick, ZMinorTick — 次刻度线 on/off 逻辑值 TickDir — 刻度线方向 'in' (默认) | 'out' | 'both' | 'none' TickLength — 刻度线长度 [0.01 0.025] (默认) | 二元素向量 标尺 XLimMode, YLimMode, ZLimMode — 坐标轴范围的选择模式 'auto' (默认) | 'manual' XLimitMethod, YLimitMethod, ZLimitMethod — 坐标轴范围选择方法'tickaligned' (默认) | 'tight' | 'padded' XAxis, YAxis, ZAxis — 轴标尺 标尺对象 XAxisLocation — x 轴位置 'bottom' (默认) | 'top' | 'origin' YAxisLocation — y 轴位置 'left' (默认) | 'right' | 'origin' XColor, YColor, ZColor — 轴线、刻度值和标签的颜色 [0.15 0.15 0.15] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ... XColorMode — 用于设置 x 轴网格颜色的属性 'auto' (默认) | 'manual' YColorMode — 用于设置 y 轴网格颜色的属性 'auto' (默认) | 'manual' ZColorMode — 用于设置 z 轴网格颜色的属性 'auto' (默认) | 'manual' XDir — x 轴方向 'normal' (默认) | 'reverse' YDir — y 轴方向 'normal' (默认) | 'reverse' ZDir — z 轴方向 'normal' (默认) | 'reverse' 网格 XGrid, YGrid, ZGrid — 网格线 'off' (默认) | on/off 逻辑值 GridLineWidth — 网格线宽度 0.5 (默认) | 正数 GridLineWidthMode — 如何设置网格线宽度 "auto" (默认) | "manual" GridColor — 网格线的颜色 [0.15 0.15 0.15] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ... GridColorMode — 用于设置网格颜色的属性 'auto' (默认) | 'manual' XMinorGrid, YMinorGrid, ZMinorGrid — 次网格线 'off' (默认) | on/off 逻辑值 MinorGridLineStyle — 次网格线的线型 ':' (默认) | '-' | '--' | '-.' | 'none' MinorGridLineWidth — 次网格线宽度 0.5 (默认) | 正数 MinorGridLineWidthMode — 如何设置次网格线宽度 "auto" (默认) | "manual" MinorGridColor — 次网格线的颜色 [0.1 0.1 0.1] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ... MinorGridColorMode — 用于设置次网格颜色的属性 'auto' (默认) | 'manual' 标签 Title — 标题的文本对象 文本对象 Subtitle — 副标题的文本对象 文本对象 TitleHorizontalAlignment — 标题和副标题水平对齐 'center' (默认) | 'left' | 'right' XLabel, YLabel, ZLabel — 坐标轴标签的文本对象 文本对象 Legend — 与坐标区关联的图例 empty GraphicsPlaceholder (默认) | Legend 对象 多个绘图 LineStyleCyclingMethod — 如何循环使用线型 "aftercolor" (默认) | "beforecolor" | "withcolor" NextSeriesIndex — 下一个对象的 SeriesIndex 值 整数 颜色图和透明度图 Colormap — 颜色图 parula (默认) | 由 RGB 三元组组成的 m×3 数组 ColorScale — 颜色图的刻度'linear' (默认) | 'log' CLim — 颜色范围 [0 1] (默认) | [cmin cmax] 形式的二元素向量 Alphamap — 透明度图 由从 0 到 1 的 64 个值组成的数组 (默认) | 由从 0 到 1 的有限 alpha 值组成的数组 AlphaScale — 透明度图的刻度'linear' (默认) | 'log' ALim — alpha 范围 [0 1] (默认) | [amin amax] 形式的二元素向量 框样式 Color — 背景色 [1 1 1] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ... LineWidth — 线条宽度 0.5 (默认) | 正数值 Box — 框轮廓 'off' (默认) | on/off 逻辑值 BoxStyle — 框轮廓样式 'back' (默认) | 'full' Clipping — 在坐标区范围内裁剪对象 'on' (默认) | on/off 逻辑值 ClippingStyle — 裁剪边界 '3dbox' (默认) | 'rectangle' AmbientLightColor — 背景光源颜色 [1 1 1] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ... 位置 InnerPosition — 内界大小和位置 [0.1300 0.1100 0.7750 0.8150] (默认) | 四元素向量 TightInset — 文本标签的边距 [left bottom right top] 形式的四元素向量 PositionConstraint — 保持不变的位置 "outerposition" | "innerposition" DataAspectRatio — 数据单元的相对长度 [1 1 1] (默认) | [dx dy dz] 形式的三元素向量 DataAspectRatioMode — 数据纵横比模式 'auto' (默认) | 'manual' PlotBoxAspectRatio — 每个坐标轴的相对长度 [1 1 1] (默认) | [px py pz] 形式的三元素向量 PlotBoxAspectRatioMode — PlotBoxAspectRatio 的选择模式 'auto' (默认) | 'manual' Layout — 布局选项 空 LayoutOptions 数组 (默认) | TiledChartLayoutOptions 对象 | GridLayoutOptions 对象 视图 View — 视图的方位角和仰角 [0 90] (默认) | [azimuth elevation] 形式的二元素向量 Projection — 二维屏幕上的投影类型 'orthographic' (默认) | 'perspective' CameraPosition — 相机位置 [x y z] 形式的三元素向量 CameraPositionMode — CameraPosition 的选择模式 'auto' (默认) | 'manual' CameraTarget — 相机目标点 [x y z] 形式的三元素向量 CameraTargetMode — CameraTarget 的选择模式 'auto' (默认) | 'manual' CameraUpVector — 定义向上方向的向量 [x y z] 形式的三元素方向向量 CameraUpVectorMode — CameraUpVector 的选择模式 'auto' (默认) | 'manual' CameraViewAngle — 视野 6.6086 (默认) | 范围 [0,180) 中的标量角 CameraViewAngleMode — CameraViewAngle 的选择模式 'auto' (默认) | 'manual' 交互性 Toolbar — 数据探索工具栏 AxesToolbar 对象 (默认) Interactions — 交互 由交互对象组成的数组 | [] Visible — 可见性状态 'on' (默认) | on/off 逻辑值 CurrentPoint — 鼠标指针的位置 2×3 数组 回调 回调执行控件 父级/子级 Parent — 父容器 Figure 对象 | Panel 对象 | Tab 对象 | TiledChartLayout 对象 | GridLayout 对象 标识符 Type — 图形对象的类型 'axes' 版本历史记录 R2023a: 使用 LineStyleCyclingMethod 属性控制线型的循环 R2023a: 使用 GridLineWidth 和 MinorGridLineWidth 属性指定网格线的粗细 R2022a: FontSmoothing 属性在以后的版本中将不起作用 R2022a: 使用 XTickLabelRotationMode、YTickLabelRotationMode 和 ZTickLabelRotationMode 属性控制刻度标签旋转 R2021b: 通过将 TickDir 属性设置为 "none" 可删除刻度线 R2021a: 使用 XLimitMethod、YLimitMethod 和 ZLimitMethod 属性控制轴范围 R2020b: 使用 TitleHorizontalAlignment 属性控制绘图标题的对齐方式 R2020b: 使用 Subtitle 和 SubtitleFontWeight 属性创建副标题并设置其样式 R2020a: 使用 PositionConstraint 属性保留内部或外部位置 R2020a: 不推荐使用 UIContextMenu 属性 R2019b: 使用 Layout 属性在分块图布局中定位坐标区 R2019a: 使用 Interactions 属性自定义图交互 R2018a: 使用 Toolbar 属性向坐标区添加工具栏 另请参阅 主题 MATLAB 命令 Americas Europe Asia Pacific

Main Content

坐标区的外观和行为

全页展开

Axes 属性控制 Axes 对象的外观和行为。通过更改属性值,您可以修改坐标区的特定方面。使用圆点表示法查询和设置属性。

ax = gca;c = ax.Color;ax.Color = 'blue';

字体

全部展开

字体大小,指定为数值标量。字体大小会影响标题、轴标签和刻度标签。还会影响与坐标区关联的任何图例或颜色栏。默认字体大小取决于具体操作系统和区域设置。默认情况下,字体大小以磅为单位进行测量。要更改单位,请设置 FontUnits 属性。

MATLAB 会自动将某些文本缩放为坐标区字体大小的百分比。

  • 标题和轴标签 - 默认情况下为坐标区字体大小的 110%。要控制缩放比例,请使用 TitleFontSizeMultiplierLabelFontSizeMultiplier 属性。

  • 图例和颜色栏 - 默认情况下为坐标区字体大小的 90%。要指定不同的字体大小,请设置 LegendColorbar 对象的 FontSize 属性。

示例: ax.FontSize = 12

字体大小的选择模式,指定为下列值之一:

  • 'auto' - 由 MATLAB 指定的字体大小。如果将坐标区的大小调整为小于默认大小,则字体大小可能会缩小以改善可读性和布局。

  • 'manual' - 手动指定的字体大小。不随坐标区大小改变而缩放字体大小。要指定字体大小,请设置 FontSize 属性。

标签字体大小的缩放因子,指定为大于 0 的数值。此缩放因子应用于 FontSize 属性的值,以确定 x 轴、y 轴和 z 轴标签的字体大小。

示例: ax.LabelFontSizeMultiplier = 1.5

标题字体大小的缩放因子,指定为大于 0 的数值。此缩放因子应用于 FontSize 属性的值,以确定标题的字体大小。

副标题字符粗细,指定为下列值之一:

  • 'normal' - 特定字体定义的默认粗细

  • 'bold' - 字符粗细比普通的粗

刻度

全部展开

刻度值,指定为由递增值组成的向量。如果您不希望沿坐标轴显示刻度线,请指定空向量 []。刻度值是坐标轴上显示刻度线的位置。刻度标签是您在每个刻度线旁边看到的标签。使用 XTickLabelsYTickLabelsZTickLabels 属性指定关联的标签。

示例: ax.XTick = [2 4 6 8 10]

示例: ax.YTick = 0:10:100

也可以使用 xticksytickszticks 函数指定刻度值。有关示例,请参阅指定坐标轴刻度值和标签

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

刻度值的选择模式,指定为下列值之一:

  • 'auto' - 根据坐标轴的数据范围自动选择刻度值。

  • 'manual' - 手动指定刻度值。要指定值,请设置 XTickYTickZTick 属性。

示例: ax.XTickMode = 'auto'

刻度标签,指定为字符向量元胞数组、字符串数组或分类数组。如果您不希望显示刻度标签,请指定空元胞数组 {}。如果您没有为所有刻度值指定足够多的标签,将会重复使用标签。

刻度标签支持 TeX 和 LaTeX 标记。有关详细信息,请参阅 TickLabelInterpreter 属性。

如果将此属性指定为分类数组,MATLAB 将使用数组中的值,而不是类别。

作为设置此属性的替代方法,您还可以使用 xticklabelsyticklabelszticklabels 函数。有关示例,请参阅指定坐标轴刻度值和标签

示例: ax.XTickLabel = {'Jan','Feb','Mar','Apr'}

刻度标签的选择模式,指定为下列值之一:

  • 'auto' - 自动选择刻度标签。

  • 'manual' - 手动指定刻度标签。要指定标签,请设置 XTickLabelYTickLabelZTickLabel 属性。

示例: ax.XTickLabelMode = 'auto'

刻度标签的旋转,指定为以度为单位的数值。正值将导致按逆时针旋转。负值产生顺时针旋转。

示例: ax.XTickLabelRotation = 45

示例: ax.YTickLabelRotation = 90

或者,使用 xtickangleytickangleztickangle 函数。

刻度标签旋转的选择模式,指定为下列值之一:

  • 'auto' - 自动选择刻度标签旋转方式。

  • 'manual' - 使用您指定的刻度标签旋转方式。要指定旋转,请设置 XTickLabelRotationYTickLabelRotationZTickLabelRotation 属性。

次刻度线,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 在坐标轴的主刻度线之间显示次刻度线。主刻度线的间距决定次刻度线的数目。此值是使用对数刻度的坐标轴的默认值。

  • 'off' - 不显示次刻度线。此值是使用线性刻度的坐标轴的默认值。

示例: ax.XMinorTick = 'on'

刻度线方向,指定为下列值之一:

  • 'in' - 刻度线从轴线指向内部。(二维视图的默认值)

  • 'out' - 刻度线从轴线指向外部。(三维视图的默认值)

  • 'both' - 刻度线以轴线为中心。

  • 'none' - 不显示任何刻度线。

刻度线长度,指定为 [2Dlength 3Dlength] 形式的二元素向量。第一个元素是二维视图中的刻度线长度,第二个元素是三维视图中的刻度线长度。指定值是以可见的 x 轴、y 轴或 z 轴中最长线条为基准进行归一化的值。

示例: ax.TickLength = [0.02 0.035]

标尺

全部展开

坐标轴范围的选择模式,指定为下列值之一:

  • 'auto' - 启用自动范围选择,具体范围基于所绘制数据的总跨度和 XLimitMethodYLimitMethodZLimitMethod 属性的值。

  • 'manual' - 手动指定坐标轴范围。要指定坐标轴范围,请设置 XLimYLimZLim 属性。

示例: ax.XLimMode = 'auto'

坐标轴范围选择方法,指定为下表中的一个值。表中的示例显示 XLimitMethod 属性不同值的大致外观。根据您的数据、坐标区的大小和您创建的绘图类型,结果可能会有所不同。

描述示例:(XLimitMethod)。
'tickaligned'

通常,将坐标区框的边缘与最接近数据的刻度线对齐,但不排除任何数据。外观可能因绘制的数据类型和创建的图类型而异。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (1)

'tight'

将坐标轴范围设置为等同于数据范围,使轴框紧密围绕数据。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (2)

'padded'

使坐标区框贴合数据,每侧只留很窄的填充边距。边距的宽度大约是数据范围的 7%。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (3)

注意

当对应的模式属性(XLimModeYLimModeZLimMode)设置为 'manual' 时,坐标轴范围方法不起作用。

轴标尺,以标尺对象的形式返回。标尺控制 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 属性存储两个标尺对象。

x 轴位置,指定为下表中的值之一。此属性仅应用于二维视图。

描述结果
'bottom'

坐标区的底部。

例如:ax.XAxisLocation = 'bottom'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (4)

'top'

坐标区的顶部。

例如:ax.XAxisLocation = 'top'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (5)

'origin'

穿过原点 (0,0)。

例如:ax.XAxisLocation = 'origin'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (6)

y 轴位置,指定为下表中的值之一。此属性仅应用于二维视图。

描述结果
'left'

坐标区的左侧。

例如:ax.YAxisLocation = 'left'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (7)

'right'

坐标区的右侧。

例如:ax.YAxisLocation = 'right'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (8)

'origin'

穿过原点 (0,0)。

例如:ax.YAxisLocation = 'origin'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (9)

xyz 方向的轴线、刻度值和标签的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。您指定的颜色还会影响网格线,除非您使用 GridColorMinorGridColor 属性指定网格线颜色。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (10)

"green""g"[0 1 0]"#00FF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (11)

"blue""b"[0 0 1]"#0000FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (12)

"cyan" "c"[0 1 1]"#00FFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (13)

"magenta""m"[1 0 1]"#FF00FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (14)

"yellow""y"[1 1 0]"#FFFF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (15)

"black""k"[0 0 0]"#000000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (16)

"white""w"[1 1 1]"#FFFFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (17)

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (18)

[0.8500 0.3250 0.0980]"#D95319"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (19)

[0.9290 0.6940 0.1250]"#EDB120"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (20)

[0.4940 0.1840 0.5560]"#7E2F8E"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (21)

[0.4660 0.6740 0.1880]"#77AC30"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (22)

[0.3010 0.7450 0.9330]"#4DBEEE"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (23)

[0.6350 0.0780 0.1840]"#A2142F"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (24)

示例: ax.XColor = [1 1 0]

示例: ax.YColor = 'y'

示例: ax.ZColor = 'yellow'

示例: ax.ZColor = '#FFFF00'

用于设置 x 轴网格颜色的属性,指定为 'auto''manual'。模式值仅影响 x 轴网格颜色。无论在什么模式下,x 轴线、刻度值和标签始终使用 XColor 值。

x 轴网格颜色取决于 XColorMode 属性和 GridColorMode 属性,如下表所示。

XColorModeGridColorModex 轴网格颜色
'auto''auto'GridColor 属性
'manual'GridColor 属性
'manual''auto'XColor 属性
'manual'GridColor 属性

x 轴次网格颜色取决于 XColorMode 属性和 MinorGridColorMode 属性,如下表所示。

XColorModeMinorGridColorModex 轴次网格颜色
'auto''auto'MinorGridColor 属性
'manual'MinorGridColor 属性
'manual''auto'XColor 属性
'manual'MinorGridColor 属性

用于设置 y 轴网格颜色的属性,指定为 'auto''manual'。模式值仅影响 y 轴网格颜色。无论在什么模式下,y 轴线、刻度值和标签始终使用 YColor 值。

y 轴网格颜色取决于 YColorMode 属性和 GridColorMode 属性,如下表所示。

YColorModeGridColorModey 轴网格颜色
'auto''auto'GridColor 属性
'manual'GridColor 属性
'manual''auto'YColor 属性
'manual'GridColor 属性

y 轴次网格颜色取决于 YColorMode 属性和 MinorGridColorMode 属性,如下表所示。

YColorModeMinorGridColorModey 轴次网格颜色
'auto''auto'MinorGridColor 属性
'manual'MinorGridColor 属性
'manual''auto'YColor 属性
'manual'MinorGridColor 属性

用于设置 z 轴网格颜色的属性,指定为 'auto''manual'。模式值仅影响 z 轴网格颜色。无论在什么模式下,z 轴线、刻度值和标签始终使用 ZColor 值。

z 轴网格颜色取决于 ZColorMode 属性和 GridColorMode 属性,如下表所示。

ZColorModeGridColorModez 轴网格颜色
'auto''auto'GridColor 属性
'manual'GridColor 属性
'manual''auto'ZColor 属性
'manual'GridColor 属性

z 轴次网格颜色取决于 ZColorMode 属性和 MinorGridColorMode 属性,如下表所示。

ZColorModeMinorGridColorModez 轴次网格颜色
'auto''auto'MinorGridColor 属性
'manual'MinorGridColor 属性
'manual''auto'ZColor 属性
'manual'MinorGridColor 属性

x 轴方向,指定为下列值之一。

描述生成二维视图生成三维视图
'normal'

值从左向右逐渐增加。

例如:ax.XDir = 'normal'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (25)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (26)

'reverse'

值从右向左逐渐增加。

例如:ax.XDir = 'reverse'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (27)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (28)

y 轴方向,指定为下列值之一。

描述生成二维视图生成三维视图
'normal'

值从下向上(二维视图)或从前向后(三维视图)逐渐增加。

例如:ax.YDir = 'normal'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (29)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (30)

'reverse'

值从上向下(二维视图)或从后向前(三维视图)逐渐增加。

例如:ax.YDir = 'reverse'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (31)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (32)

z 轴方向,指定为下列值之一。

描述生成三维视图
'normal'

值按从内向外(二维视图)或从下向上(三维视图)逐渐增加。

例如:ax.ZDir = 'normal'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (33)

'reverse'

值按从外向内(二维视图)或从上向下(三维视图)逐渐增加。

例如:ax.ZDir = 'reverse'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (34)

网格

全部展开

网格线,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 坐标轴正交的网格线,例如,沿着常量 xyz 值对应的线条。

  • 'off' - 不显示网格线。

还可以使用 grid ongrid off 命令将所有三个属性分别设置为 'on''off'。有关详细信息,请参阅 grid

示例: ax.XGrid = 'on'

自 R2023a 起

网格线宽度,指定为正数。设置此属性或 MinorGridLineWidth 属性可独立于框轮廓和刻度线控制网格线的粗细。

示例

创建向量 xy,并对其绘图。通过调用 grid on 显示坐标区中的网格线。通过将坐标区的 LineWidth 属性设置为 1.5,增大网格线、框轮廓和刻度线的粗细。

x = linspace(0,10);y = sin(x);plot(x,y)grid onax = gca;ax.LineWidth = 1.5;

坐标区的外观和行为 - MATLAB- MathWorks 中国 (35)

通过将网格线宽度设置为 0.5 使网格线变细。

ax.GridLineWidth = 0.5;

坐标区的外观和行为 - MATLAB- MathWorks 中国 (36)

自 R2023a 起

如何设置网格线宽度,指定为以下值之一:

  • "auto" - 将 GridLineWidth 属性设置为与 LineWidth 属性相同的值。

  • "manual" - 保留 GridLineWidth 属性的当前值。

当您将 GridLineWidth 属性显式设置为一个值时,MATLAB 会将此属性设置为 "manual"

网格线的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (37)

"green""g"[0 1 0]"#00FF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (38)

"blue""b"[0 0 1]"#0000FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (39)

"cyan" "c"[0 1 1]"#00FFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (40)

"magenta""m"[1 0 1]"#FF00FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (41)

"yellow""y"[1 1 0]"#FFFF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (42)

"black""k"[0 0 0]"#000000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (43)

"white""w"[1 1 1]"#FFFFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (44)

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (45)

[0.8500 0.3250 0.0980]"#D95319"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (46)

[0.9290 0.6940 0.1250]"#EDB120"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (47)

[0.4940 0.1840 0.5560]"#7E2F8E"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (48)

[0.4660 0.6740 0.1880]"#77AC30"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (49)

[0.3010 0.7450 0.9330]"#4DBEEE"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (50)

[0.6350 0.0780 0.1840]"#A2142F"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (51)

要为坐标区框轮廓设置颜色,请使用 XColorYColorZColor 属性。

要显示网格线,请使用 grid on 命令或将 XGridYGridZGrid 属性设置为 'on'

示例: ax.GridColor = [0 0 1]

示例: ax.GridColor = 'b'

示例: ax.GridColor = 'blue'

示例: ax.GridColor = '#0000FF'

用于设置网格颜色的属性,指定为下列值之一:

  • 'auto' - 检查 XColorModeYColorModeZColorMode 属性的值,以确定 x、y 和 z 方向的网格线颜色。

  • 'manual' - 使用 GridColor 设置所有方向的网格线颜色。

次网格线,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 显示与轴的次刻度线对齐的网格线。不必启用次刻度即可显示次网格线。

  • 'off' - 不显示网格线。

或者使用 grid minor 命令切换次网格线的可见性。

示例: ax.XMinorGrid = 'on'

次网格线的线型,指定为下表中显示的线型之一。

线型描述表示的线条
"-"实线

坐标区的外观和行为 - MATLAB- MathWorks 中国 (52)

"--"虚线

坐标区的外观和行为 - MATLAB- MathWorks 中国 (53)

":"点线

坐标区的外观和行为 - MATLAB- MathWorks 中国 (54)

"-."点划线

坐标区的外观和行为 - MATLAB- MathWorks 中国 (55)

"none"无线条无线条

要显示次网格线,请使用 grid minor 命令或将 XMinorGridYMinorGridZMinorGrid 属性设置为 'on'

示例: ax.MinorGridLineStyle = '-.'

自 R2023a 起

次网格线宽度,指定为正数。设置此属性或 GridLineWidth 属性可独立于框轮廓和刻度线控制网格线的粗细。

提示

  • 要查看次网格线,请将 XMinorGridYMinorGridZMinorGrid 属性设置为 "on"

  • 当您设置 GridLineWidth 属性时,MATLAB 会同时将 MinorGridLineWidth 属性设置为相同的值。要避免更改 MinorGridLineWidth 属性,请在设置 GridLineWidth 属性之前,将 MinorGridLineWidthMode 属性设置为 "manual"

自 R2023a 起

如何设置次网格线宽度,指定为以下值之一:

  • "auto" - 将 MinorGridLineWidth 属性设置为与 GridLineWidth 属性相同的值。

  • "manual" - 保留 MinorGridLineWidth 属性的当前值。

当您将 MinorGridLineWidth 属性显式设置为一个值时,MATLAB 会将此属性设置为 "manual"

次网格线的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (56)

"green""g"[0 1 0]"#00FF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (57)

"blue""b"[0 0 1]"#0000FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (58)

"cyan" "c"[0 1 1]"#00FFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (59)

"magenta""m"[1 0 1]"#FF00FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (60)

"yellow""y"[1 1 0]"#FFFF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (61)

"black""k"[0 0 0]"#000000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (62)

"white""w"[1 1 1]"#FFFFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (63)

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (64)

[0.8500 0.3250 0.0980]"#D95319"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (65)

[0.9290 0.6940 0.1250]"#EDB120"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (66)

[0.4940 0.1840 0.5560]"#7E2F8E"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (67)

[0.4660 0.6740 0.1880]"#77AC30"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (68)

[0.3010 0.7450 0.9330]"#4DBEEE"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (69)

[0.6350 0.0780 0.1840]"#A2142F"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (70)

要显示次网格线,请使用 grid minor 命令或将 XMinorGridYMinorGridZMinorGrid 属性设置为 'on'

示例: ax.MinorGridColor = [0 0 1]

示例: ax.MinorGridColor = 'b'

示例: ax.MinorGridColor = 'blue'

示例: ax.MinorGridColor = '#0000FF'

用于设置次网格颜色的属性,指定为下列值之一:

  • 'auto' - 检查 XColorModeYColorModeZColorMode 属性的值,以确定 x、y 和 z 方向的网格线颜色。

  • 'manual' - 使用 MinorGridColor 设置所有方向的次网格线颜色。

标签

全部展开

坐标区标题的文本对象。要添加标题,请设置文本对象的 String 属性。要更改标题外观,例如字体样式或字体颜色,请设置其他属性。有关完整列表,请参阅 Text 属性

ax = gca;ax.Title.String = 'My Title';ax.Title.FontWeight = 'normal';

也可以使用 title 函数添加标题并控制外观。

title('My Title','FontWeight','normal')

注意

此文本对象不包含在坐标区的 Children 属性中,它不能由 findobj 返回,也不使用为文本对象定义的默认值。

坐标区副标题的文本对象。要添加副标题,请设置文本对象的 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'标题和副标题位于图框上方的居中位置。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (71)

'left'标题和副标题与图框的左侧对齐。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (72)

'right'标题和副标题与图框的右侧对齐。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (73)

轴标签的文本对象。要添加轴标签,请设置文本对象的 String 属性。要更改标签外观,例如字号,请设置其他属性。有关完整列表,请参阅 Text 属性

ax = gca;ax.YLabel.String = 'My y-Axis Label';ax.YLabel.FontSize = 12;

也可以使用 xlabelylabelzlabel 函数添加轴标签并控制外观。

ylabel('My y-Axis Label','FontSize',12)

注意

这些文本对象不包含在坐标区的 Children 属性中,它们不能由 findobj 返回,也不使用为文本对象定义的默认值。

此 属性 为只读。

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

多个绘图

全部展开

自 R2023a 起

当坐标区中有多条线时如何循环使用线型,指定为下表中的值之一。

下表中的示例是使用 ColorOrder 属性中的默认颜色和 LineStyleOrder 属性中的三种线型 (["-","-o","--"]) 创建的。

描述示例

"aftercolor"

先循环使用 ColorOrder 的颜色,再循环使用 LineStyleOrder 的线型。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (74)

"beforecolor"

先循环使用 LineStyleOrder 的线型,再循环使用 ColorOrder 的颜色。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (75)

"withcolor"

循环使用 LineStyleOrder 的线型的同时循环使用 ColorOrder 的颜色。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (76)

此 属性 为只读。

添加到坐标区的下一个绘图对象的 SeriesIndex 值,以大于或等于 0 的整数形式返回。当您要跟踪对象如何循环使用颜色和线型时,此属性非常有用。此属性维护坐标区中具有数值 SeriesIndex 属性值的对象的计数。MATLAB 使用它为每个新对象分配 SeriesIndex 值。计数在创建坐标区时从 1 开始,每增加一个对象,计数就会增加 1。因此,该计数通常是 n+1,其中 n 是坐标区中对象的数量。

如果您手动更改 ColorOrderIndex 或坐标区上的 LineStyleOrderIndex 属性,NextSeriesIndex 属性的值将更改为 0。因此,当您更改坐标区上的 ColorOrderLineStyleOrder 属性时,具有 SeriesIndex 属性的对象不再自动更新。

颜色图和透明度图

全部展开

颜色图,指定为由 RGB(红色、绿色、蓝色)三元组组成的 m×3 数组,这些三元组定义 m 种单独的颜色。

示例: ax.Colormap = [1 0 1; 0 0 1; 1 1 0] 将颜色图设置为三种颜色:品红色、蓝色和黄色。

MATLAB 按行号访问这些颜色。

也可以使用 colormap 函数更改颜色图。

颜色图的刻度,指定为下列值之一:

  • 'linear' - 线性刻度。颜色栏上的刻度值也使用线性刻度。

  • 'log' - 对数刻度。颜色栏上的刻度值也使用对数刻度。

坐标区中使用颜色图的对象的颜色范围,指定为 [cmin cmax] 形式的二元素向量。此属性用来确定数据值如何映射到颜色图中的颜色,其中:

  • cmin 指定映射到颜色图中的第一个颜色的数据值。

  • cmax 指定映射到颜色图中的最后一个颜色的数据值。

Axes 对象根据颜色图中 cmincmax 所规定的范围进行数据值插值。此范围外的值使用第一个或最后一个颜色(取最接近的值)。

透明度图,指定为从 01 线性递增的有限 alpha 值组成的数组。数组大小可以是 m×1 或 1×m。MATLAB 按 alpha 值在数组中的索引访问来它们。Alphamap 可以为任意长度。

透明度图的刻度,指定为下列值之一:

  • 'linear' - 线性刻度

  • 'log' - 对数刻度

alpha 范围,指定为 [amin amax] 形式的二元素向量。此属性影响图形对象(如曲面、图像和补片对象)的 AlphaData 值。此属性决定 AlphaData 值如何映射到图窗 alpha 映射,其中:

  • amin 指定映射到图窗 alpha 映射的第一个 alpha 值的数据值。

  • amax 指定映射到图窗 alpha 映射的最后一个 alpha 值的数据值。

Axes 对象根据图窗的 alpha 映射中 aminamax 所规定的范围进行数据值插值。此范围外的值使用第一个或最后一个 alpha 映射值(取最接近的值)。

图窗的 Alphamap 属性包含 alpha 映射。有关详细信息,请参阅 alpha 函数。

框样式

全部展开

背景颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (77)

"green""g"[0 1 0]"#00FF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (78)

"blue""b"[0 0 1]"#0000FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (79)

"cyan" "c"[0 1 1]"#00FFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (80)

"magenta""m"[1 0 1]"#FF00FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (81)

"yellow""y"[1 1 0]"#FFFF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (82)

"black""k"[0 0 0]"#000000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (83)

"white""w"[1 1 1]"#FFFFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (84)

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (85)

[0.8500 0.3250 0.0980]"#D95319"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (86)

[0.9290 0.6940 0.1250]"#EDB120"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (87)

[0.4940 0.1840 0.5560]"#7E2F8E"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (88)

[0.4660 0.6740 0.1880]"#77AC30"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (89)

[0.3010 0.7450 0.9330]"#4DBEEE"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (90)

[0.6350 0.0780 0.1840]"#A2142F"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (91)

示例: ax.Color = [0 0 1];

示例: ax.Color = 'b';

示例: ax.Color = 'blue';

示例: ax.Color = '#0000FF';

坐标区轮廓、刻度线和网格线的线宽,指定为正数值(以磅为单位)。一磅等于 1/72 英寸。

示例: ax.LineWidth = 1.5

框轮廓,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

描述二维结果三维结果
'on'

显示坐标区周围的框轮廓。对于三维视图,可以使用 BoxStyle 属性更改轮廓的范围。

例如:ax.Box = 'on'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (92)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (93)

'off'

不显示坐标区周围的框轮廓。

例如:ax.Box = 'off'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (94)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (95)

XColorYColorZColor 属性控制轮廓的颜色。

示例: ax.Box = 'on'

框轮廓样式,指定为 'back''full'。此属性仅影响三维视图。

描述结果
'back'

画出三维框的背板轮廓。

例如:ax.BoxStyle = 'back'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (96)

'full'

画出整个三维框的轮廓。

例如:ax.BoxStyle = 'full'

坐标区的外观和行为 - MATLAB- MathWorks 中国 (97)

按照坐标区范围裁剪对象,指定为 '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'所有对象都不裁剪。

裁剪边界,指定为下表中的值之一。如果绘图包含标记,则只要数据点位于坐标区范围内,MATLAB 就会绘制整个标记。

如果 Clipping 属性设置为 'off',则 ClippingStyle 属性无效。

描述边界区域图示
'3dbox'

按照坐标轴范围定义的坐标区框的六条边对绘制对象进行裁剪。

粗线可能会显示在坐标区范围之外。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (98)

'rectangle'

在任何给定视图中按照包围坐标区的矩形边界对绘制对象进行裁剪。

在坐标区范围处裁剪粗线。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (99)

背景光颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。背景光是一种无向光,均匀地照射在坐标区内的所有对象上。要添加光源,请使用 light 函数。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (100)

"green""g"[0 1 0]"#00FF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (101)

"blue""b"[0 0 1]"#0000FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (102)

"cyan" "c"[0 1 1]"#00FFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (103)

"magenta""m"[1 0 1]"#FF00FF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (104)

"yellow""y"[1 1 0]"#FFFF00"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (105)

"black""k"[0 0 0]"#000000"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (106)

"white""w"[1 1 1]"#FFFFFF"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (107)

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (108)

[0.8500 0.3250 0.0980]"#D95319"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (109)

[0.9290 0.6940 0.1250]"#EDB120"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (110)

[0.4940 0.1840 0.5560]"#7E2F8E"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (111)

[0.4660 0.6740 0.1880]"#77AC30"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (112)

[0.3010 0.7450 0.9330]"#4DBEEE"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (113)

[0.6350 0.0780 0.1840]"#A2142F"

坐标区的外观和行为 - MATLAB- MathWorks 中国 (114)

示例: ax.AmbientLightColor = [1 0 1]

示例: ax.AmbientLightColor = 'm'

示例: ax.AmbientLightColor = 'magenta'

示例: ax.AmbientLightColor = '#FF00FF'

位置

全部展开

内部尺寸和位置,指定为 [left bottom width height] 形式的四元素向量。此属性等同于 Position 属性。

注意

  • 当查询具有约束纵横比的坐标区(如方形坐标区或包含图像的坐标区)的内部位置时,可考虑使用 tightPosition 函数以获得更高的准确度。(从 R2022b 开始)

  • 当父容器为 TiledChartLayout 时,设置此属性不起作用

此 属性 为只读。

文本标签的边距,以 [left bottom right top] 形式的四元素向量返回。默认情况下,MATLAB 按照归一化的容器单位来测量值。要更改单位,请设置 Units 属性。

这些元素定义 Position 属性的边界与周围文本之间的距离。将 Position 值与 TightInset 值结合使用可定义包围坐标区和周围文本的最紧凑的边界框。

下面的图显示由 OuterPosition 值(蓝色)、Position 值(红色)以及由 TightInset 值(品红色)外扩的 Position 定义的区域。

二维坐标区视图三维坐标区视图

坐标区的外观和行为 - MATLAB- MathWorks 中国 (115)

坐标区的外观和行为 - MATLAB- MathWorks 中国 (116)

有关详细信息,请参阅控制坐标区布局

在增加、删除或更改装饰元素时保持不变的位置属性,指定为下列值之一:

  • "outerposition" - 在添加、删除或更改装饰元素(例如标题或轴标签)时,OuterPosition 属性保持不变。如需任何位置调整,MATLAB 会调整 InnerPosition 属性。

  • "innerposition" - 在添加、删除或更改装饰元素(例如标题或轴标签)时,InnerPosition 属性保持不变。如需任何位置调整,MATLAB 会调整 OuterPosition 属性。

注意

当父容器为 TiledChartLayout 对象时,设置此属性不起作用。

数据单位沿每个坐标轴的相对长度,指定为 [dx dy dz] 形式的三元素向量。此向量定义相对的 xyz 数据缩放因子。例如,若将该属性指定为 [1 2 1],会将 x 方向中的一个数据单位长度设置为等同于 y 方向中的两个数据单位长度和 z 方向中的一个数据单位长度。

也可以使用 daspect 函数更改数据纵横比。

示例: ax.DataAspectRatio = [1 1 1]

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

数据纵横比模式,指定为下列值之一:

  • 'auto' - 自动选择能够充分利用可用空间的值。如果 PlotBoxAspectRatioModeCameraViewAngleMode 也设置为 'auto',将启用“伸展填充”行为。伸展坐标区,使其填满 Position 属性定义的可用空间。

  • 'manual' - 禁用“伸展填充”行为并使用手动指定的数据纵横比。要指定值,请设置 DataAspectRatio 属性。

每个坐标轴的相对长度,指定为 [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

PlotBoxAspectRatio 属性的选择模式,指定为下列值之一:

  • 'auto' - 自动选择能够充分利用可用空间的值。如果 DataAspectRatioModeCameraViewAngleMode 也设置为 'auto',将启用“伸展填充”行为。伸展 Axes 对象,使其填满 Position 属性定义的可用空间。

  • 'manual' - 禁用“伸展填充”行为并使用手动指定的图框纵横比。要指定值,请设置 PlotBoxAspectRatio 属性。

布局选项,指定为 TiledChartLayoutOptionsGridLayoutOptions 对象。当坐标区对象位于分块图布局或网格布局中时,此属性非常有用。

要在分块图布局的网格中定位坐标区,请设置 TiledChartLayoutOptions 对象的 TileTileSpan 属性。例如,假设有一个 3×3 分块图布局。布局的中心有一个包含若干图块的网格,外边缘四周各有一个图块。实际上,该网格不可见,外侧图块也不占用空间,除非您用坐标区或图填充它们。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (117)

以下代码将坐标区 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

如果此坐标区不是分块图布局或网格布局的子级(例如,如果它是图窗或面板的子级),则此属性为空且不起作用。

视图

全部展开

视图的方位角和仰角,指定为以度为单位定义的 [azimuth elevation] 形式的二元素向量。也可以使用 view 函数设置视图。

注意

设置方位角和仰角可能会重置其他与相机相关的属性。为了获得最佳效果,请在设置其他与相机相关的属性之前设置方位角和仰角。

示例: ax.View = [45 45]

二维屏幕上的投影类型,指定为下列值之一:

  • 'orthographic' - 保持图形对象的正确相对维度(就给定点到观察者之间的距离而言),并在屏幕上根据平行数据绘制平行线条。

  • 'perspective' - 使用前缩透视法,这可以让您在三维对象的二维表示形式中表现景深。透视投影不会保留对象的相对维度。它改为显示较远的线段短于较近的等长线段。按数据平行的线条在屏幕上可能显示为不平行。

相机位置或视点,指定为 [x y z] 形式的三元素向量。此向量定义相机位置(即您观察坐标区的点)的坐标区坐标。相机沿视图轴指定方向,该轴是一条连接相机位置和相机目标的直线。有关说明,请参阅相机图形术语

如果 Projection 属性设置为 'perspective',则当您更改 CameraPosition 设置时,透视量也会更改。

也可以使用 campos 函数设置相机位置。

示例: ax.CameraPosition = [0.5 0.5 9]

数据类型: single | double

CameraPosition 属性的选择模式,指定为下列值之一:

  • 'auto' - 沿观察轴自动设置 CameraPosition。计算位置,使相机沿当前视图(view 函数返回的视图)指定的方位角和仰角与目标保持固定的距离。诸如 rotate3dzoompan 之类的函数会将此模式更改为 'auto' 以执行其操作。

  • 'manual' - 手动指定值。要指定值,请设置 CameraPosition 属性。

相机目标点,指定为 [x y z] 形式的三元素向量。此向量定义点的轴坐标。相机沿视图轴指定方向,该轴是一条连接相机位置和相机目标的直线。有关说明,请参阅相机图形术语

也可以使用 camtarget 函数设置相机目标。

示例: ax.CameraTarget = [0.5 0.5 0.5]

数据类型: single | double

CameraTarget 属性的选择模式,指定为下列值之一:

  • 'auto' - 将相机目标置于轴图框矩心。

  • 'manual' - 使用手动指定的相机目标值。要指定值,请设置 CameraTarget 属性。

定义向上方向的向量,指定为 [x y z] 形式的三元素方向向量。对于二维视图,默认值为 [0 1 0]。对于三维视图,默认值为 [0 0 1]。有关说明,请参阅相机图形术语

也可以使用 camup 函数设置向上的方向。

示例: ax.CameraUpVector = [sin(45) cos(45) 1]

CameraUpVector 属性的选择模式,指定为下列值之一:

  • 'auto' - 对于三维视图,自动将值设置为 [0 0 1],使 z 轴正方向朝上。对于二维视图,将值设置为 [0 1 0],使 y 轴正方向朝上。

  • 'manual' - 手动指定定义向上方向的向量。要指定值,请设置 CameraUpVector 属性。

视野,指定为大于 0 且小于或等于 180 的标量角。更改相机视角会影响坐标区中显示的图形对象的大小,但不会影响透视变形度。角度越大,视野越大,而场景中显示的对象就越小。有关说明,请参阅相机图形术语

示例: ax.CameraViewAngle = 15

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

CameraViewAngle 属性的选择模式,指定为下列值之一:

  • 'auto' - 自动选择能够捕获整个场景的最小角度作为视野(最高可达 180 度)。

  • 'manual' - 手动指定视野。要指定值,请设置 CameraViewAngle 属性。

交互性

全部展开

数据探索工具栏,它是一个 AxesToolbar 对象。将鼠标悬停在坐标区上时,工具栏会显示在坐标区的右上角。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (118)

工具栏按钮取决于坐标区的内容,但通常包括缩放、平移、旋转、数据提示、数据刷亮和还原原始视图。您可以使用 axtoolbaraxtoolbarbtn 函数自定义工具栏按钮。

如果您不希望在将鼠标悬停在坐标区上时显示工具栏,请将 AxesToolbar 对象的 Visible 属性设置为 'off'

ax = gca;ax.Toolbar.Visible = 'off';

有关详细信息,请参阅 AxesToolbar 属性

交互,指定为由交互对象组成的数组或空数组。可以通过手势在图中使用您指定的交互。您不必选择任何坐标区工具栏按钮即可使用它们。例如,可以通过 panInteraction 对象在图中拖动以进行平移。有关交互对象的列表,请参阅对图的交互进行控制

默认的交互集取决于您所显示的图的类型。您可以将默认集替换为新的交互集,但不能访问或修改默认集中的任何交互。例如,以下代码用 panInteractionzoomInteraction 对象替换默认交互集。

ax = gca;ax.Interactions = [panInteraction zoomInteraction];

要从坐标区中删除所有交互,请将此属性设置为空数组。要暂时禁用当前交互集,请调用 disableDefaultInteractivity 函数。您可以通过调用 enableDefaultInteractivity 函数来重新启用它们。

注意

findobjfindall 不会返回交互对象,copyobj 也不会复制交互对象。

可见性状态,指定为 'on''off',或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true'off' 等效于 false。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

  • 'on' - 显示坐标区及其子级。

  • 'off' - 隐藏坐标区而不删除它。您仍然可以访问不可见坐标区对象的属性。

注意

Visible 属性为 'off' 时,坐标区对象不可见,但线条等子对象仍然可见。

此 属性 为只读。

鼠标指针的位置,以 2×3 数组形式返回。CurrentPoint 属性包含鼠标指针相对于坐标区的 (x,y,z) 坐标。返回的数组采用如下形式:

[xfront yfront zfront xback yback zback]

这两点指示最后一次鼠标点击的位置。但是,如果图窗定义了 WindowButtonMotionFcn 回调,则这些点指示鼠标指针最后所在的位置。图窗还有一个 CurrentPoint 属性。

由于坐标区立方体的形状可能有所不同,因此使用透视投影时当前点的值可能不同于正交投影中的同一点。

正交投影

使用正交投影时,值取决于点击的位置在坐标区内还是坐标区外。

  • 如果点击位置在坐标区内,则这两个点位于与屏幕平面垂直并穿过指针的直线上。坐标表示这条直线与坐标区立方体(由轴 x、y 和 z 的范围定义)的前平面和后平面相交的点。第一行表示距离相机位置最近的点。第二行表示距相机位置最远的点。这适用于二维和三维视图。

  • 如果点击位置在坐标区外但在图窗内,则点位于穿过指针并垂直于相机目标和相机位置平面的直线上。第一行是相机位置平面上的点。第二行是相机目标平面上的点。

透视投影

在透视投影中,在 Axes 对象外点击将返回前点作为当前相机位置。只有后点的坐标才会更新,即相机位置与鼠标指针连线的延长线与相机目标的交点的坐标。

回调

全部展开

回调执行控件

全部展开

父级/子级

全部展开

父容器,指定为 FigurePanelTabTiledChartLayoutGridLayout 对象。

标识符

全部展开

此 属性 为只读。

图形对象的类型,以 'axes' 形式返回。

版本历史记录

在 R2006a 之前推出

全部展开

使用 LineStyleCyclingMethod 属性控制如何在坐标区中区分不同的线条。

通过设置坐标区的 GridLineWidthMinorGridLineWidth 属性,独立于框轮廓和刻度线更改网格线的粗细。在 R2023a 之前,坐标区的 LineWidth 属性是控制网格线宽度的唯一属性。但是,该属性同时控制网格线、框轮廓和刻度线。现在,您可以单独控制网格线的粗细。

FontSmoothing 属性在以后的版本中将不起作用。无论该属性的值如何,都将启用字体平滑处理。

现在,您可以通过设置 XTickLabelRotationModeYTickLabelRotationModeZTickLabelRotationMode 属性来控制刻度标签旋转的选择模式。

通过将 TickDir 属性设置为 "none" 可删除坐标区上的所有刻度线。

通过在坐标区上设置 XLimitMethodYLimitMethodZLimitMethod,控制绘图的坐标轴范围。

通过将坐标区的 TitleHorizontalAlignment 属性设置为 "left""right""center",可以控制绘图标题的对齐方式。

通过设置 Subtitle 属性或调用 subtitle 函数向绘图添加副标题。要控制副标题的外观,请设置 SubtitleFontWeight 属性。

设置 Axes 对象的 PositionConstraint 属性,以便在添加或修改标题和轴标签等装饰元素时控制图框周围的空间。

使用 Layout 属性在分块图布局中定位 Axes 对象。

通过设置坐标区的 Interactions 属性,可以创建一组自定义的图交互。这些交互内置于坐标区中,无需选择坐标区工具栏中的任何按钮即可使用。根据坐标区的内容,某些类型的交互默认处于启用状态。

使用 Toolbar 属性将工具栏添加到坐标区的右上角,以便快速访问数据探索工具。

另请参阅

axes | axis | gca | cla | box | grid

主题

  • 访问属性值
  • 图形对象属性

MATLAB 命令

您点击的链接对应于以下 MATLAB 命令:

 

请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。

坐标区的外观和行为 - MATLAB- MathWorks 中国 (119)

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

Europe

Asia Pacific

Contact your local office

坐标区的外观和行为 - MATLAB
- MathWorks 中国 (2024)
Top Articles
Latest Posts
Article information

Author: Manual Maggio

Last Updated:

Views: 5668

Rating: 4.9 / 5 (69 voted)

Reviews: 84% of readers found this page helpful

Author information

Name: Manual Maggio

Birthday: 1998-01-20

Address: 359 Kelvin Stream, Lake Eldonview, MT 33517-1242

Phone: +577037762465

Job: Product Hospitality Supervisor

Hobby: Gardening, Web surfing, Video gaming, Amateur radio, Flag Football, Reading, Table tennis

Introduction: My name is Manual Maggio, I am a thankful, tender, adventurous, delightful, fantastic, proud, graceful person who loves writing and wants to share my knowledge and understanding with you.