zticklabels

设置或查询 z 轴刻度标签

全页折叠

语法

zticklabels(labels)
zl = zticklabels
zticklabels('auto')
zticklabels('manual')
m = zticklabels('mode')
___ = zticklabels(ax,___)

说明

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 object. The axes object contains an object of type surface.

打开实时脚本

从 R2019b 开始，您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。创建两个三维针状图。通过将 ax1 作为 zticks 和 zticklabels 函数的第一个输入参量进行传递，设置第一个图的 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 objects. Axes object 1 contains an object of type stem. Axes object 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 object. The axes object contains an object of type surface.

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

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

打开实时脚本

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

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

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

输入参数

全部折叠

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

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

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

示例: zticklabels({})

注意

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

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

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

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

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

输出参量

全部折叠

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

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

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

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

详细信息

全部折叠

算法

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

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

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

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

版本历史记录

在 R2016b 中推出

另请参阅

函数

属性