NumericRuler 属性

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

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

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

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

轴线和刻度线的宽度，指定为以磅为单位的正值。一磅等于 1/72 英寸。

示例: ax.XAxis.LineWidth = 2;

轴标签，它是一个文本对象。要显示文本或更改现有文本，请设置文本对象的 String 属性。使用其他属性更改文本外观，例如字体样式或颜色。

ax = gca;
ax.XAxis.Label.String = 'X Axis';
ax.XAxis.Label.FontSize = 12;

如需完整的选项列表，请参阅 Text 属性。

或者，使用 xlabel、ylabel 和 zlabel 函数添加或修改轴标签。

轴标签水平对齐，指定为表中的值之一。

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

示例: ax.XAxis.Visible = 'off';

最小和最大坐标轴范围，指定为 [min max] 形式的二元素向量。

如果您赋值给此属性，则 MATLAB 会将相关联的模式设置为 'manual'。

或者，使用 xlim、ylim 和 zlim 函数设置范围。

示例: ax.XAxis.Limits = [-10 10];

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

值沿坐标轴的刻度，指定为 'linear' 或 'log'。

示例: ax.XAxis.Scale = 'log';

增加值的方向，指定为下列值之一：

示例: ax.XAxis.Direction = 'reverse';

坐标轴上的刻度线位置，指定为由递增值组成的向量。

示例: ax.XAxis.TickValues = [2 4 6 8 10];

示例: ax.XAxis.TickValues = 0:10:100;

如果您为此属性赋值，则 MATLAB 会将 TickValuesMode 属性设置为 'manual'。

或者，使用 xticks、yticks 和 zticks 函数。

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

所有刻度值通用的指数记数法，指定为整数值。该轴显示次级标签 10⁵。

底数值始终为 10。但是，您可以通过设置 Exponent 属性更改指数值。例如，将指数更改为 2。

ax = gca;
ax.YAxis.Exponent = 2;

如果指数值为 0，则不会显示指数标签。

如果您为此属性赋值，则 MATLAB 会将 ExponentMode 属性设置为 'manual'。如果轴使用对数刻度，则 Exponent 属性不起作用。

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

刻度线标签，指定为字符向量元胞数组、字符串数组或分类数组。如果您没有为所有刻度值指定足够多的标签，将会重复使用标签。标签支持 TeX 和 LaTeX 标记。有关详细信息，请参阅 TickLabelInterpreter 属性。

示例: ax.XAxis.TickLabels = {'January','February','March','April','May'}';

示例: ax.YAxis.TickLabels = {'\pi','2\pi','3\pi'}'

如果您设置此属性，则 MATLAB 会将 TickLabelsMode 属性设置为 'manual'。

或者，使用 xticklabels、yticklabels 和 zticklabels 函数指定刻度标签。

数据类型: char | string | categorical

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

刻度标签颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

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

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

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

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

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 个字符。

有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。有关 LaTeX 系统的详细信息，请访问 LaTeX Project 网站：https://www.latex-project.org/。

刻度标签格式和小数精度，指定为字符向量或字符串。例如，您可以按照货币格式显示刻度标签、控制每个标签中显示的小数位数，或在所有标签后添加文本。

示例: ax.XAxis.TickLabelFormat = '%g%%'; 会在所有刻度标签后显示百分比符号。

下表列出了部分常用的格式。

$0.01
$1.00
$1,000.00

0.01o
1o
1000o

0.01%
1%
1000%

0.01
1
1,000

或者，使用 xtickformat、ytickformat 和 ztickformat 函数指定刻度标签格式。

自定义格式

如果上表中列出的格式都不是您需要的格式，则可以创建一个带标识符的自定义字符向量或字符串。

标识符是可选的，百分比符号和转换字符除外。按以下顺序构造格式：

您还可以在格式的开头或末尾指定字面文本。要打印单引号，请使用 ''。要打印百分比字符，请使用 %%。

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

您也可以使用 xtickangle、ytickangle 和 ztickangle 函数旋转刻度标签。

示例: ax.XAxis.TickLabelRotation = 45;

示例: ax.YAxis.TickLabelRotation = -45;

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

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

如果您为此属性赋值，则 MATLAB 会将 TickDirectionMode 属性设置为 'manual'。

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

刻度线长度，指定为 [2Dlength 3Dlength] 形式的二元素向量。第一个元素是二维视图中的刻度线长度。第二个元素是三维视图中的刻度线长度。指定值时采用的是以坐标区最长维度为基准的归一化单位。

示例: ax.YAxis.TickLength = [0.02 0.035];

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

示例: ax.XAxis.MinorTick = 'on';

次刻度线位置，指定为由递增值组成的向量。

示例: ax.XAxis.MinorTickValues = [0 0.5 1 1.5 2 2.5];

示例: ax.YAxis.MinorTickValues = 0:5:100;

如果您赋值给此属性，则 MATLAB 会将 MinorTickValuesMode 属性设置为 'manual'。

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

字体名称，指定为系统支持的字体名称或 'FixedWidth'。默认字体取决于特定的操作系统和区域设置。要使用渲染效果好的等宽字体，请指定 'FixedWidth'。使用的实际等宽字体取决于根对象的 FixedWidthFontName 属性。

示例: ax.XAxis.FontName = 'Cambria';

字体大小，指定为数值标量。默认字体大小取决于具体操作系统和区域设置。

示例: ax.XAxis.FontSize = 12;

文本字符的粗细，指定为下列值之一：

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

示例: ax.XAxis.FontWeight = 'bold';

字符倾斜，指定为 'normal' 或 'italic'。并非所有字体都有两种字体样式。因此，斜体可能看上去与常规字体一样。

示例: ax.XAxis.FontAngle = 'italic';

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

示例: ax.XAxis.FontSmoothing = 'off';

坐标轴范围更改后执行的回调，指定为下列值之一：

此回调在坐标轴范围更改后执行，或以编程方式执行，或使用交互（例如在坐标区内平移）执行。当您调用绘图函数时，如果 MATLAB 更改坐标轴范围以包含您的数据范围，也会执行此回调。

此回调函数可以访问有关轴范围的特定信息。MATLAB 在 LimitsChanged 对象中将此信息作为第二个参量传递给回调函数。如果您在 App 设计工具中开发 App，该参量称为 event。您可以使用圆点表示法查询对象属性。例如，event.NewLimits 返回新坐标轴范围。LimitsChanged 对象不可用于指定为字符向量的回调函数。

下表列出了 LimitsChanged 对象的属性。

有关在 App 中编写回调的详细信息，请参阅App 设计工具中的回调。

标尺的父级，指定为 Axes 对象。

标尺没有任何子级。您不能设置该属性。