Main Content

rticklabels

设置或查询 r 轴刻度标签

说明

示例

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

rl = rticklabels 返回当前坐标区的 r 轴刻度标签。

示例

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

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

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

示例

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

示例

全部折叠

创建一个极坐标图。在 r 轴上的值 0.1、0.3 和 0.5 处显示刻度线和网格线。然后为每个刻度线指定一个标签。

theta = linspace(0,2*pi);
rho = theta/10;
polarplot(theta,rho)
rticks([0.1 0.25 0.5])
rticklabels({'r = .1','r = .3','r = .5'})

创建一个极坐标图,并将极坐标区对象赋给变量 pax。通过指定 pax 作为 rticksrticklabels 函数的第一个输入参量,确保这两个函数作用于您刚创建的极坐标区。

theta = 0:0.01:2*pi;
rho = 50*sin(2*theta);
polarplot(theta,rho)
pax = gca;

rticks(pax,[10 25 50])
rticklabels(pax,{'r = 10','r = 25','r = 50'})

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

theta = linspace(0,2*pi);
rho = theta/10;
polarplot(theta,rho)
rticks([0.1 0.25 0.5])
rticklabels({'r = .1','r = .3','r = .5'})

rticks('auto')
rticklabels('auto')

通过指定刻度标签为空数组,删除 r 轴上的刻度标签。

theta = 0:0.01:2*pi;
rho = 50*sin(2*theta);
polarplot(theta,rho)
rticklabels({})

输入参数

全部折叠

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

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

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

示例: rticklabels({})

注意

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

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

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

极坐标区或极坐标区数组。如果不指定此参量,则 rticklabels 会修改当前坐标区(前提是当前坐标区是极坐标区对象)。

输出参量

全部折叠

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

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

  • 'auto' - 坐标区自动确定 r 轴刻度标签。

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

详细信息

全部折叠

刻度标签

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

Tick marks appear as circular lines along the r-axis. Tick labels for tick values appear as text directly on each tick mark line.

算法

rticklabels 函数可设置和查询与 r 轴刻度标签相关的多个极坐标区属性。

  • RTickLabel - 存储 r 轴刻度标签文本的属性。

  • RTickLabelMode - 存储 r 轴刻度标签模式的属性。当您使用 rticklabels 设置 r 轴刻度标签时,此属性将更改为 'manual'

  • RTickMode - 存储 r 轴刻度值模式的属性。当您使用 rticklabels 设置 r 轴刻度标签时,此属性将更改为 'manual'

版本历史记录

在 R2016b 中推出