xticklabels

设置或查询 x 轴刻度标签

语法

xticklabels(labels)

xl = xticklabels

xticklabels('auto')

xticklabels('manual')

m = xticklabels('mode')

___ = xticklabels(ax,___)

说明

xticklabels(labels) 设置当前坐标区的 x 轴刻度标签。可将 labels 指定为字符串数组或字符向量元胞数组，例如 {'January','February','March'}。如果指定标签，则 x 轴刻度值和刻度标签不会再基于坐标区的更改而自动更新。

xl = xticklabels 返回当前坐标区的 x 轴刻度标签。

xticklabels('auto') 设置自动模式，使坐标区确定 x 轴刻度标签。如果您设置了标签，然后又想将它们设置回默认值，则可以使用此选项。

xticklabels('manual') 设置手动模式，将 x 轴刻度标签冻结在当前值。

m = xticklabels('mode') 返回 x 轴刻度标签模式的当前值：'auto' 或 'manual'。默认情况下，该模式为自动，除非您指定刻度标签或将模式设置为手动。

___ = xticklabels(ax,___) 使用 ax 指定的坐标区，而不是使用当前坐标区。指定 ax 作为上述任何语法的第一个输入参量。

示例

指定 x 轴刻度值和标签

创建一个线图。在值 0、5 和 10 处显示 x 轴的刻度线。然后为每个刻度线指定一个标签。

x = linspace(0,10);
y = x.^2;
plot(x,y)
xticks([0 5 10])
xticklabels({'x = 0','x = 5','x = 10'})

以 Pi 为单位显示 x 轴刻度标签

创建一个线图。指定 x 坐标轴范围并沿 x 轴显示以 $$\pi$$ 为增量的刻度线。

x = linspace(0,6*pi);
y = sin(x);
plot(x,y)
xlim([0 6*pi])
xticks(0:pi:6*pi)

MATLAB® 用数值标注刻度线。通过为每个标签指定文本来更改标签以显示 $$\pi$$ 符号。

xticklabels({'0','\pi','2\pi','3\pi','4\pi','5\pi','6\pi'})

指定特定坐标区的 x 轴刻度标签

从 R2019b 开始，您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。创建两个随机数据的绘图。通过将 ax2 指定为第一个输入参量，设置第二个图的 x 轴刻度值和标签。

tiledlayout(2,1)
ax1 = nexttile;
plot(ax1,rand(3))

ax2 = nexttile;
plot(ax2,rand(3))
xticks(ax2,[1 2 3])
xticklabels(ax2,{'one','two','three'})

将 x 轴刻度标签设置回默认标签

创建一个针状图并指定 x 轴刻度值和对应的标签。然后，将 x 轴刻度值和标签设置回默认值。

stem(1:10)
xticks([1 4 6 10])
xticklabels({'A','B','C','D'})

xticks('auto')
xticklabels('auto')

删除 x 轴刻度标签

通过将刻度标签指定为空数组来删除 x 轴的刻度标签。

plot(rand(5))
xticklabels({})

输入参数

labels — 刻度标签

字符向量元胞数组 | 字符串数组 | 分类数组

刻度标签，指定为字符向量元胞数组、字符串数组或分类数组。如果您不希望显示刻度标签，请指定空元胞数组 {}。刻度标签支持 TeX 和 LaTeX 标记。有关详细信息，请参阅 Axes 对象的 TickLabelInterpreter 属性。

示例: xticklabels({'0','\pi','2\pi'})

示例: xticklabels({'January','February','March'})

示例: xticklabels({})

注意

• 要指定刻度值，请使用 xticks 函数。

• 如果没有为所有刻度值指定足够的标签，则 MATLAB^® 会为其余的刻度使用空字符向量标签。

• 如果将刻度标签指定为分类数组，MATLAB 将使用数组中的值，而不是类别。

ax — 目标坐标区

Axes 对象 | Axes 对象数组

目标坐标区，指定为 Axes 对象或 Axes 对象数组。

如果不指定此参量，则 xticklabels 会修改当前坐标区。

输出参量

xl — 当前刻度标签

字符向量元胞数组 | 字符数组

当前刻度标签，以字符向量元胞数组或字符数组形式返回。

m — 当前刻度标签模式

'auto' | 'manual'

当前刻度标签模式，返回为下列值之一：

• 'auto' - 自动确定 x 轴刻度标签。

• 'manual' - 使用手动指定的 x 轴刻度标签。

详细信息

刻度标签

刻度标签是您在每个刻度线旁边看到的标签。刻度值是 x 轴上显示刻度线的位置。使用 xticks 函数设置值。使用 xticklabels 函数设置对应的标签。

算法

xticklabels 函数设置并查询与 x 轴刻度标签有关的多个坐标区属性。

• XTickLabel - 用于存储 x 轴刻度标签的文本的属性。

• XTickLabelMode - 用于存储 x 轴刻度标签模式的属性。使用 xticklabels 设置 x 轴刻度标签时，此属性更改为 'manual'。

• XTickMode - 用于存储 x 轴刻度值模式的属性。使用 xticklabels 设置 x 轴刻度标签时，此属性更改为 'manual'。

版本历史记录

在 R2016b 中推出

另请参阅

函数

• xtickformat | xticks | xlim | xsecondarylabel | xtickangle

属性

• Axes 属性

主题

• 指定坐标轴刻度值和标签