DurationRuler 属性

轴线和标签的颜色，指定为 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)) 获取十六进制颜色代码。

轴线和刻度线的宽度，指定为以磅为单位的正值。一磅等于 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] 形式的二元素向量，其中 min 和 max 是持续时间值。例如：

d = duration(1,40:45,0);
y = rand(6,1);
plot(d,y)
ax = gca;
ax.XAxis.Limits = [d(2) d(5)];

您可以指定两个极限值，也可以指定一个极限值，再让标尺使用 Inf 或 -Inf 持续时间值自动计算另一个极限值，例如 days(Inf)。

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

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

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

值沿轴的刻度，返回 'linear'。DurationRuler 对象不支持对数标度。

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

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

轴上的刻度线位置，指定为持续时间值的向量。例如：

d = duration(1,40:45,0);
y = rand(6,1);
plot(d,y)
ax = gca;
ax.XAxis.TickValues = [d(1) d(3) d(5)];

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

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

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

所有刻度值通用的指数记数法，指定为整数值。Exponent 属性仅适用于显示单个时间单位（例如秒、分钟或小时）的刻度标签。它不适用于显示混合时间单位的刻度标签。如果适用，标尺显示的指数标签会显示底数和指数值。

底数值始终为 10。您可以通过设置 Exponent 属性更改指数值。如果指数值为 0，则不会显示指数标签。

例如，此代码将指数值更改为 8。

x = hours((1:10)*1e10);
plot(x,1:10)
ax = gca;
ax.XAxis.Exponent = 8;

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

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 函数指定刻度标签。

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

刻度标签颜色，指定为 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)) 获取十六进制颜色代码。

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

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 的示例，请参阅图文本中的希腊字母和特殊字符。

刻度标签格式，指定为字符向量或字符串标量。

要将持续时间显示为包含小数部分（例如 1.234 小时）的单个数字，请指定下列格式之一。

要以数字计时器的形式显示持续时间，请指定下列格式之一：

此外，可以通过附加多达 9 个 S 字符显示多达 9 位小数的秒位。例如，'hh:mm:ss.SSS' 以三位数显示持续时间的毫秒数。

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

您也可以使用 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';

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

如果您赋值给此属性，则 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';

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

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

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

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

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

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

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