Main Content

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

zticks

设置或查询 z 轴刻度值

说明

示例

zticks(ticks) 设置 z刻度值,这些值是 z 轴上显示刻度线的位置。指定 ticks 为递增值向量;例如 [0 2 4 6]。此命令作用于当前坐标区。

zt = zticks 以向量形式返回当前 z 轴刻度值。

示例

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

zticks('manual') 设置手动模式,将 z 轴刻度值冻结在当前值。如果您希望在调整坐标区大小或者向坐标区添加新数据时保留当前刻度值,则可以使用此选项。

m = zticks('mode') 返回当前 z 轴刻度值模式:'auto''manual'。默认情况下,模式为自动,除非您指定刻度值或将模式更改为手动。

示例

___ = zticks(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.

沿 z 轴以介于 -10 和 10 之间的非均匀值显示刻度线。MATLAB® 用数值标注刻度线。

[x,y,z] = peaks;
surf(peaks)
zticks([-10 -2.5 0 2.5 10])

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

沿 z 轴以 2 为增量显示刻度线,从 -10 开始,在 10 结束。

[x,y,z] = peaks;
surf(peaks)
zticks([-10:2:10])

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

创建一个绘图并指定 z 轴刻度值。然后,将 z 轴刻度值设置回默认值。

t = 0:pi/50:10*pi;
st = sin(t);
ct = cos(t);
plot3(st,ct,t)
zticks(0:8:40)

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

zticks('auto')

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

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

tiledlayout(2,1)
ax1 = nexttile;
stem3(ax1,4*rand(5))
zticks(ax1,[0 1.5 3.25])

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 轴的刻度线。删除刻度线还会删除 z 方向上的任何网格线。

[x,y,z] = peaks;
mesh(x,y,z)
zticks([])

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

输入参数

全部折叠

刻度值,指定为由递增值组成的向量。如果您不需要沿 z 轴的刻度线,请指定空向量 []

您可以指定数值、分类、日期时间或持续时间值形式的刻度值。但是,您指定的值的类型必须匹配 z 轴的值的类型。

示例: zticks([pi 2*pi 3*pi 4*pi])

示例: zticks(0:10:100)

示例: zticks([])

注意

要指定刻度标签,请使用 zticklabels 函数。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

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

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

输出参数

全部折叠

当前刻度值,以向量的形式返回。

当前模式,返回为下列值之一:

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

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

详细信息

全部折叠

刻度值

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

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

算法

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

  • ZTick - 用于存储 z 轴刻度值的属性。

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

版本历史记录

在 R2016b 中推出