Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

zticklabels

设置或查询 z 轴刻度标签

说明

示例

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

zl = zticklabels 返回当前坐标区的 z 轴刻度标签。

示例

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

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

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

示例

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

示例

全部折叠

创建一个曲面图。在 z 轴的值 -8、0 和 8 处显示刻度线。然后为每个刻度线指定一个标签。

[x,y,z] = peaks;
surf(x,y,z)
zticks([-8 0 8])
zticklabels({'z = -8','z = 0','z = 8'})

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

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

tiledlayout(2,1)
ax1 = nexttile;
stem3(ax1,4*rand(5))
zticks(ax1,[0 2 4])
zticklabels(ax1,{'z = 0','z = 2','z = 4'})

ax2 = nexttile;
stem3(ax2,4*rand(5))

Figure contains 2 axes. Axes 1 contains an object of type stem. Axes 2 contains an object of type stem.

创建一个曲面图并指定 z 轴刻度值和标签。然后,将这些值和标签设置回默认值。

[x,y,z] = peaks;
mesh(x,y,z)
zticks([-8 0 8])
zticklabels({'z = -8','z = 0','z = 8'})

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

zticks('auto')
zticklabels('auto')

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

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

[x,y,z] = peaks;
surf(x,y,z)
zticklabels({})

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

输入参数

全部折叠

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

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

示例: zticklabels({'January','Febrary','March'})

示例: zticklabels({})

注意

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

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

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

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

输出参数

全部折叠

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

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

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

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

详细信息

全部折叠

刻度标签

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

算法

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

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

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

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

在 R2016b 中推出