Axes 属性

字体名称，指定为支持的字体名称或 "FixedWidth"。要正确显示和打印文本，您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体，请使用 "FixedWidth"。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

字符粗细，指定为 'normal' 或 'bold'。

MATLAB^® 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能得到普通字体。

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

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

示例: ax.FontSize = 12

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

字符倾斜，指定为 'normal' 或 'italic'。

并非所有字体都有两种字体样式。因此，斜体可能看上去和常规字体一样。

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

示例: ax.LabelFontSizeMultiplier = 1.5

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

标题字符的粗细，指定为下列值之一：

副标题字符粗细，指定为下列值之一：

字体大小单位，指定为下列值之一。

要在同一个函数调用中设置字体大小和字体单位，必须先设置 FontUnits 属性，以便 Axes 对象能够正确解释指定的字体大小。

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

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

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

也可以使用 xticks、yticks 和 zticks 函数指定刻度值。有关示例，请参阅指定坐标轴刻度值和标签。

刻度值的选择模式，指定为下列值之一：

示例: ax.XTickMode = 'auto'

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

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

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

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

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

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

示例: ax.XTickLabelMode = 'auto'

刻度标签解释器，指定为下列值之一：

TeX 标记

默认情况下，MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标，修改文本类型和颜色，并在标签中包括特殊字符。

修饰符会一直作用到文本结尾，但上标和下标除外，因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex" 时，支持的修饰符如下所示。

下表列出了 "tex" 解释器所支持的特殊字符。

LaTeX 标记

要使用 LaTeX 标记，请将 TickLabelInterpreter 属性设置为 'latex'。使用美元符号将标签括起来，例如，对于行内模式，使用 '$\int_1^{20} x^2 dx$'；对于行间模式，使用 '$$\int_1^{20} x^2 dx$$'。

显示的文本将使用默认的 LaTeX 字体样式。FontName、FontWeight 和 FontAngle 属性不起任何作用。要更改字体样式，请在文本中使用 LaTeX 标记。用于 LaTeX 解释器的文本最多可以包含 1200 个字符。对于多行文本，需在此基础上每行再减少约 10 个字符。

MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息，请参阅支持的 LaTeX 命令。有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。

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

示例: ax.XTickLabelRotation = 45

示例: ax.YTickLabelRotation = 90

或者，使用 xtickangle、ytickangle 和 ztickangle 函数。

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

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

示例: ax.XMinorTick = 'on'

刻度线方向，指定为下列值之一：

TickDir 属性的选择模式，指定为下列值之一：

示例: ax.TickDirMode = 'auto'

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

示例: ax.TickLength = [0.02 0.035]

最小和最大范围，指定为 [min max] 形式的二元素向量，其中 max 大于 min。您可以将范围指定为数字、分类、日期时间或持续时间值。但您指定的值类型必须与坐标轴上的值类型匹配。

您可以指定这两个范围，也可以指定一个范围而让 MATLAB 自动计算另一个范围。对于自动计算的最小或最大范围，请分别使用 -inf 或 inf。MATLAB 使用 'tight' 范围方法计算对应的范围。

示例: ax.XLim = [0 10]

示例: ax.YLim = [-inf 10]

示例: ax.ZLim = [0 inf]

也可以使用 xlim、ylim 和 zlim 函数设置这些范围。有关示例，请参阅指定坐标轴范围。

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

示例: ax.XLimMode = 'auto'

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

轴标尺，以标尺对象的形式返回。标尺控制 x 轴、y 轴或 z 轴的外观和行为。通过访问相关的标尺并设置标尺属性，可以修改坐标轴的外观和行为。MATLAB 为每个轴创建的标尺类型取决于绘制的数据。有关 Axes 对象支持的标尺属性的列表，请参阅：

例如，通过 XAxis 属性访问 x 轴的标尺。然后，更改标尺的 Color 属性，使 x 轴的颜色为红色。同样，将 y 轴的颜色更改为绿色。

ax = gca;
ax.XAxis.Color = 'r';
ax.YAxis.Color = 'g';

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

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

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

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

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

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

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

示例: ax.YColor = 'y'

示例: ax.ZColor = 'yellow'

示例: ax.ZColor = '#FFFF00'

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

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

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

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

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

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

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

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

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

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

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

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

坐标轴刻度，指定为下列值之一。

值	描述	结果
'linear'	线性刻度 示例：ax.XScale = 'linear'
'log'	对数刻度 示例：ax.XScale = 'log' 注意 坐标区在某些情况下可能会排除坐标： 如果坐标包括正值和负值，则仅显示正值。 如果坐标均为负值，所有值都带适当的符号显示在对数刻度上。 不显示零值。

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

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

示例: ax.XGrid = 'on'

网格线和刻度线相对于图形对象的位置，指定为下列值之一：

此属性仅影响二维视图。

示例: ax.Layer = 'top'

网格线的线型，指定为下表中的线型之一。

要显示网格线，请使用 grid on 命令或将 XGrid、YGrid 或 ZGrid 属性设置为 'on'。

示例: ax.GridLineStyle = '--'

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

示例

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

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

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

ax.GridLineWidth = 0.5;

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

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

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

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

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

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

要为坐标区框轮廓设置颜色，请使用 XColor、YColor 和 ZColor 属性。

要显示网格线，请使用 grid on 命令或将 XGrid、YGrid 或 ZGrid 属性设置为 'on'。

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

示例: ax.GridColor = 'b'

示例: ax.GridColor = 'blue'

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

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

网格线透明度，指定为范围 [0,1] 中的值。值为 1 表示不透明，值为 0 表示完全透明。

示例: ax.GridAlpha = 0.5

GridAlpha 属性的选择模式，指定为下列值之一：

示例: ax.GridAlphaMode = 'auto'

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

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

示例: ax.XMinorGrid = 'on'

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

要显示次网格线，请使用 grid minor 命令或将 XMinorGrid、YMinorGrid 或 ZMinorGrid 属性设置为 'on'。

示例: ax.MinorGridLineStyle = '-.'

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

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

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

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

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

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

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

要显示次网格线，请使用 grid minor 命令或将 XMinorGrid、YMinorGrid 或 ZMinorGrid 属性设置为 'on'。

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

示例: ax.MinorGridColor = 'b'

示例: ax.MinorGridColor = 'blue'

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

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

次网格线透明度，指定为范围 [0,1] 中的值。值为 1 表示不透明，值为 0 表示完全透明。

示例: ax.MinorGridAlpha = 0.5

MinorGridAlpha 属性的选择模式，指定为下列值之一：

示例: ax.MinorGridAlphaMode = 'auto'

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

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

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

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

坐标区副标题的文本对象。要添加副标题，请设置文本对象的 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';

标题和副标题与图框水平对齐，指定为下表中的值之一。

轴标签的文本对象。要添加轴标签，请设置文本对象的 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)

与 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.Legend
if ~isempty(lgd)
    disp('Legend Exists')
end

色序，指定为由 RGB 三元组组成的三列矩阵。此属性定义 MATLAB 创建绘图对象（例如 Line、Scatter 和 Bar 对象）时使用的颜色的调色板。数组的每一行都是一个 RGB 三元组。RGB 三元组是包含三个元素的向量，其元素分别指定颜色的红、绿、蓝分量的强度。强度必须在 [0, 1] 范围内。下表列出了默认颜色。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

MATLAB 根据对象的创建顺序为对象分配颜色。例如，在绘制线条时，第一条线用第一种颜色，第二条线用第二种颜色，以此类推。如果线条比颜色多，则循环使用颜色。

在绘图之前或之后更改色序

您可以通过下列任一方式更改色序：

线型序列，指定为字符向量、字符向量元胞数组或字符串数组。此属性列出了 MATLAB 在坐标区中显示多个绘图线条时使用的线型。MATLAB 根据创建线条的顺序为它们分配线型。默认情况下，只有在对当前线型用尽 ColorOrder 属性中的所有颜色后，它才会开始使用下一线型。将 LineStyleCyclingMethod 属性设置为 "withcolor" 会同时循环使用两者，设置为 "beforecolor" 会首先循环使用线型。默认的 LineStyleOrder 只有一个线型 "-"。

要自定义线型序列，请创建一个字符向量元胞数组或字符串数组。将数组的每个元素指定为下列各表中的一个线条设定符或标记设定符。您可以在一个元素中组合使用线型和标记设定符，如 "-*"。

在绘图之前或之后更改线型序列

您可以在坐标区中绘图之前或之后更改线型序列。当 LineStyleOrder 属性设置为新值时，MATLAB 会更新坐标区中所有线条的线型。如果继续在坐标区中绘图，绘图命令会继续使用更新后的列表中的线型。

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

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

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

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

在向坐标区中添加新绘图时要重置的属性，指定为下列值之一：

图窗对象还有一个 NextPlot 属性。也可以使用 newplot 函数准备图窗和坐标区，以执行后续的图形命令。

渲染对象的顺序，指定为下列值之一：

色序索引，指定为正整数。此属性指定当 MATLAB 创建下一个绘图对象（例如 Line、Scatter 或 Bar 对象）时从坐标区 ColorOrder 属性中选择的下一个颜色。

线型序列索引，指定为正整数。此属性指定 MATLAB 在创建下一个绘图线条时从坐标区 LineStyleOrder 属性中选择的下一个线型。

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

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

MATLAB 按行号访问这些颜色。

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

颜色图的刻度，指定为下列值之一：

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

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

CLim 属性的选择模式，指定为下列值之一：

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

透明度图的刻度，指定为下列值之一：

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

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

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

ALim 属性的选择模式，指定为下列值之一：

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

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

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

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

示例: 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 逻辑值。

XColor、YColor 和 ZColor 属性控制轮廓的颜色。

示例: ax.Box = 'on'

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

按照坐标区范围裁剪对象，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

Axes 对象内某个对象的裁剪行为由 Axes 对象的 Clipping 属性和该具体对象的 Clipping 属性共同决定。Axes 对象的属性值具有以下作用：

下表列出了 Clipping 属性值的不同组合结果。

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

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

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

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

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

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

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

示例: ax.AmbientLightColor = 'm'

示例: ax.AmbientLightColor = 'magenta'

示例: ax.AmbientLightColor = '#FF00FF'

大小和位置，包括标签和边距，指定为 [left bottom width height] 形式的四元素向量。默认情况下，MATLAB 按照归一化的容器单位来测量值。要更改单位，请设置 Units 属性。[0 0 1 1] 的默认值包括容器的整个内部。

下图显示由 OuterPosition 值（蓝色）和 Position 值（红色）定义的区域。

有关坐标区位置的详细信息，请参阅控制坐标区布局。

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

大小和位置，不包括标签边距，指定为 [left bottom width height] 形式的四元素向量。默认情况下，MATLAB 按照归一化的容器单位来测量值。要更改单位，请设置 Units 属性。

如果要指定位置并考虑让文本围绕坐标区，请改为设置 OuterPosition 属性。下图显示由 OuterPosition 值（蓝色）和 Position 值（红色）定义的区域。

有关坐标区位置的详细信息，请参阅控制坐标区布局。

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

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

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

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

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

位置单位，指定为下列值之一：

在对象创建过程中将单位指定为 Name,Value 对组时，您必须先设置 Units 属性，然后再指定要使用这些单位的属性（如 Position）。

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

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

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

数据纵横比模式，指定为下列值之一：

每个坐标轴的相对长度，指定为 [px py pz] 形式的三元素向量，三个元素分别定义 x 轴、y 轴和 z 轴的相对缩放因子。图框是包含坐标轴范围定义的轴数据区域的框。

也可以使用 pbaspect 函数更改图框纵横比。

如果您指定了坐标轴范围、数据纵横比和图框纵横比，MATLAB 将忽略图框纵横比，而遵守坐标轴范围和数据纵横比。

示例: ax.PlotBoxAspectRatio = [1 0.75 0.75]

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

布局选项，指定为 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。

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

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

示例: ax.View = [45 45]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

示例: ax.CameraViewAngle = 15

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

自定义交互行为的选项，指定为 CartesianAxesInteractionOptions 对象。使用 CartesianAxesInteractionOptions 对象的属性自定义与坐标区的交互行为。有关完整的属性列表，请参阅 CartesianAxesInteractionOptions Properties。

CartesianAxesInteractionOptions 对象设置的选项适用于相关联的坐标区上的以下交互：

示例: ax.InteractionOptions.LimitsDimensions = "x" 将所有平移和缩放交互约束为在 x 维度上进行。

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

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

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

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

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

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

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

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

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

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

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

[xfront yfront zfront
 xback  yback  zback]

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

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

正交投影

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

透视投影

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

上下文菜单，指定为 ContextMenu 对象。使用此属性在您右键点击对象时显示上下文菜单。使用 uicontextmenu 函数创建上下文菜单。

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

选择时显示选择句柄，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

鼠标点击回调，指定为下列值之一：

使用此属性在您点击对象时执行代码。如果使用函数句柄指定此属性，则 MATLAB 在执行回调时将向回调函数传递两个参量：

有关如何使用函数句柄定义回调函数的详细信息，请参阅Create Callbacks for Graphics Objects。

对象创建函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

此属性指定要在 MATLAB 创建对象时执行的回调函数。MATLAB 将在执行 CreateFcn 回调之前初始化所有属性值。如果不指定 CreateFcn 属性，则 MATLAB 执行默认的创建函数。

对现有组件设置 CreateFcn 属性没有任何作用。

如果将此属性指定为函数句柄或元胞数组，则可以使用回调函数的第一个参量访问正在创建的对象。否则，使用 gcbo 函数访问该对象。

对象删除函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

此属性指定在 MATLAB 删除对象时要执行的回调函数。MATLAB 在销毁对象的属性之前执行 DeleteFcn 回调。如果不指定 DeleteFcn 属性，则 MATLAB 执行默认的删除函数。

如果将此属性指定为函数句柄或元胞数组，则可以使用回调函数的第一个参量访问要删除的对象。否则，使用 gcbo 函数访问该对象。

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

此属性确定是否可以中断运行中回调。有以下两种回调状态要考虑：

每次执行处理回调队列的命令时，MATLAB 都会确定回调中断行为。这些命令包括 drawnow、figure、uifigure、getframe、waitfor 和 pause。

如果运行中回调不包含上述命令之一，则不会发生中断。MATLAB 首先完成执行运行中回调，然后执行中断回调。

如果运行中回调确实包含上述命令之一，则由运行中回调所属对象的 Interruptible 属性来确定是否发生中断：

回调排队，指定为 'queue' 或 'cancel'。BusyAction 属性决定 MATLAB 如何处理中断回调的执行。有以下两种回调状态要考虑：

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

在这些情况下，由中断回调所属对象的 BusyAction 属性确定 MATLAB 如何处理中断回调。以下是 BusyAction 属性的可能值：

捕获鼠标点击的能力，指定为以下值之一：

如果希望某个对象在其位于其他不需要点击的对象下方时可点击，请将其他对象的 PickableParts 属性设置为 'none' 以使点击穿过它们。

对捕获的鼠标点击的响应，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。