Main Content

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

zlabel

为 z 轴添加标签

说明

示例

zlabel(txt) 使用文本 txt 为当前坐标区的 z 轴添加标签。重新发出 zlabel 命令可使新标签替换旧标签。

示例

zlabel(txt,Name,Value) 还使用一个或多个 Name,Value 对组参数指定文本对象属性。

zlabel(ax,___) 将标签添加到 ax 指定的坐标区。此语法允许您指定要向其添加标签的坐标区。ax 可位于上述语法中任何输入参数组合的前面。

h = zlabel(___) 返回用作 z 轴标签的文本对象的句柄。该句柄对于以后修改标签非常有用。

示例

全部折叠

surf(peaks)
zlabel('Height')

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

figure
surf(peaks)
zlabel(123)

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

MATLAB® 将 123 显示在 z 轴旁边。

使用多行元胞数组创建多行标签。

figure
surf(peaks)
zlabel({'First Line';'Second Line'})

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

使用 Name,Value 对组设置 z 轴标签的字体大小、字体粗细和文本颜色属性。

figure
surf(peaks)
zlabel('Elevation','FontSize',12,...
       'FontWeight','bold','Color','r')

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

'FontSize',12 采用 12 磅字体显示标签文本。'FontWeight','bold' 将文本设置为粗体。'Color','r' 将文本颜色设置为红色。

从 R2019b 开始,您可以使用 tiledlayoutnexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1ax2。创建两个曲面图,通过将 ax2 指定为 zlabel 的第一个输入参数,将 z 轴标签添加到第二个图。

tiledlayout(2,1)
ax1 = nexttile;
surf(ax1,peaks(30))

ax2 = nexttile;
surf(ax2,peaks(45))
zlabel(ax2,'Height')

Figure contains 2 axes objects. Axes object 1 contains an object of type surface. Axes object 2 contains an object of type surface.

z 轴添加标签并返回用作标签的文本对象。

surf(peaks)
t = zlabel('Population Change');

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

将标签的颜色设置为红色。使用圆点表示法设置属性。

t.Color = 'red';

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

输入参数

全部折叠

轴标签,指定为字符串标量、字符向量、字符串数组、字符数组、元胞数组、分类数组或数值。

示例: 'my label'

示例: {'first line','second line'}

示例: 123

要将数值变量和文本包括在标签中,请使用 num2str 函数。例如:

x = 42;
txt = ['The value is ',num2str(x)];

要包括特殊字符(例如上标、下标、希腊字母或数学符号),请使用 TeX 标记。有关支持的标记的列表,请参阅 Interpreter 属性。

创建多行标签:

  • 使用字符串数组,其中每个元素包含一行文本,例如 ["first line","second line"]

  • 使用元胞数组,其中每个元胞包含一行文本,例如 {'first line','second line'}

  • 使用字符数组,其中每一行包含相同数量的字符,例如 ['abc'; 'ab ']

  • 使用 sprintf 创建包含换行符的文本,例如 sprintf('first line \n second line')

数值标签将通过 sprintf('%g',value) 转换为文本。例如,12345678 显示为 1.23457e+07

注意

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

  • 词语 defaultfactoryremove 是保留字,作为标准字符引用时,标签中将不会出现。要在文本中单独显示这些单词中的任意单词,需在该单词之前放置反斜杠,例如 '\default''\remove'

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

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

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参数名称,Value 是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: 'Color','red','FontSize',12 指定红色的 12 磅字体。

除了以下属性之外,还可以使用 Name,Value 对组参数指定其他文本对象属性。请参阅 Text 属性

字体大小,指定为大于 0 的标量值(以磅为单位)。一磅等于 1/72 英寸。要更改字体单位,请使用 FontUnits 属性。

设置关联坐标区的字体大小属性还会影响标签字体大小。标签字体大小会更新为等于坐标区字体大小与标签缩放因子的积。坐标区的 FontSize 属性包含坐标区字体大小。坐标区的 LabelFontSizeMultiplier 属性包含标签缩放因子。默认情况下,坐标区字体大小为 10 磅,缩放因子为 1.1,因此 z 轴标签字体大小为 11 磅。

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

字符粗细,指定为 'normal''bold'

MATLAB 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此,指定加粗字体仍可能得到普通字体。

字体名称,指定为支持的字体名称或 "FixedWidth"。要正确显示和打印文本,您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体,请使用 "FixedWidth"。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

文本颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

文本方向,指定为以度为单位的标量值。0 度的旋转值可使文本处于水平。对于垂直文本,请将此属性设置为 90-90。设置为正值可逆时针旋转文本。设置为负值可顺时针旋转文本。

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

文本解释器,指定为下列值之一:

  • 'tex' - 使用 TeX 标记子集解释字符。

  • 'latex' - 使用 LaTeX 标记解释字符。

  • 'none' - 显示字面字符。

TeX 标记

默认情况下,MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标,修改字体类型和颜色,并在文本中包括特殊字符。

修饰符会一直作用到文本结尾,但上标和下标除外,因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 'tex' 时,支持的修饰符如下所示。

修饰符描述示例
^{ }上标'text^{superscript}'
_{ }下标'text_{subscript}'
\bf粗体'\bf text'
\it斜体'\it text'
\sl伪斜体(通常与斜体相同)'\sl text'
\rm常规字体'\rm text'
\fontname{specifier}字体名称 - 将 specifier 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。'\fontname{Courier} text'
\fontsize{specifier}字体大小 - 将 specifier 替换为以磅为单位的数值标量值。'\fontsize{15} text'
\color{specifier}字体颜色 - 将 specifier 替换为以下颜色之一:redgreenyellowmagentablueblackwhitegraydarkGreenorangelightBlue'\color{magenta} text'
\color[rgb]{specifier}自定义字体颜色 - 将 specifier 替换为三元素 RGB 三元组。'\color[rgb]{0,0.5,0.5} text'

下表列出了 'tex' 解释器所支持的特殊字符。

字符序列符号字符序列符号字符序列符号

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

ϕ

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

LaTeX 标记

要使用 LaTeX 标记,请将解释器设置为 'latex'。对于行内模式,用单美元符号 ($) 将标记括起来。对于显示模式,用双美元符号 ($$) 将标记括起来。

LaTeX 模式示例结果
行内

'$\int_1^{20} x^2 dx$'

Equation with LaTeX inline mode

显示

'$$\int_1^{20} x^2 dx$$'

Equation with LaTeX display mode

显示的文本将使用默认的 LaTeX 字体样式。FontNameFontWeightFontAngle 属性不起任何作用。要更改字体样式,请使用 LaTeX 标记。

用于 LaTeX 解释器的文本最多可以包含 1200 个字符。对于多行文本,请在此数量的基础上每行减少约 10 个字符。

有关使用 TeX 和 LaTeX 的示例,请参阅图文本中的希腊字母和特殊字符。有关 LaTeX 系统的详细信息,请访问 LaTeX Project 网站:https://www.latex-project.org/

输出参数

全部折叠

用作 z 轴标签的文本对象。使用 h 可在创建标签后访问和修改标签的属性。

提示

  • 默认情况下,Interactions 属性包含 editInteraction,因此可以通过点击文本来编辑文本。要禁用此交互,请将文本对象的 Interactions 属性设置为 []

版本历史记录

在 R2006a 之前推出