Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

yticklabels

设置或查询 y 轴刻度标签

说明

示例

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

yl = yticklabels 返回当前坐标区的 y 轴刻度标签。

示例

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

yticklabels('manual') 设置手动模式,将 y 轴刻度标签冻结在当前值。

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

示例

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

示例

全部折叠

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

x = linspace(0,10);
y = x.^2;
plot(x,y)
yticks([0 50 100])
yticklabels({'y = 0','y = 50','y = 100'})

Figure contains an axes object. The axes object contains an object of type line.

从 R2019b 开始,您可以使用 tiledlayoutnexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1ax2。创建两个随机数据的绘图。通过将 ax2 作为 yticksyticklabels 函数的第一个输入参数进行传递,设置第二个图的 y 轴刻度值和标签。

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

ax2 = nexttile;
plot(rand(3))
yticks(ax2,[0 .25 .5 .75 1])
yticklabels(ax2,{'y = 0','1/4','1/2','3/4','y = 1'})

Figure contains 2 axes objects. Axes object 1 contains 3 objects of type line. Axes object 2 contains 3 objects of type line.

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

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

Figure contains an axes object. The axes object contains an object of type stem.

yticks('auto')
yticklabels('auto')

Figure contains an axes object. The axes object contains an object of type stem.

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

plot(rand(5))
yticklabels({})

Figure contains an axes object. The axes object contains 5 objects of type line.

输入参数

全部折叠

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

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

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

示例: yticklabels({})

注意

  • 要指定刻度值,请使用 yticks 函数。

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

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

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

如果不指定此参数,则 yticklabels 会修改当前坐标区。

输出参数

全部折叠

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

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

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

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

详细信息

全部折叠

刻度标签

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

Tick marks appear as short horizontal hashes along the y-axis. Tick labels for tick values appear as text directly to the left of each tick mark.

算法

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

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

  • YTickLabelMode - 用于存储 y 轴刻度标签模式的属性。使用 yticklabels 设置 y 轴刻度标签时,此属性将更改为 'manual'

  • YTickMode - 用于存储 y 轴刻度值模式的属性。使用 yticklabels 设置 y 轴刻度标签时,此属性将更改为 'manual'

版本历史记录

在 R2016b 中推出