Syslab使用手册
⋮
2026a

# title

添加标题

函数库: TyPlot

# 语法

title(txt)
title(target,txt)

title(___,Key=Value)
t = title(___)

# 说明

title(txt) 将指定的标题添加到 gca 命令返回的坐标区或图中。重新发出 title 命令可使新标题替换旧标题。示例

title(target，txt) 将标题添加到指定的目标对象。示例

title(___,Key=Value) 使用一个或多个名称-值对组参数修改标题外观。有关属性和说明的列表，请参阅 text 属性。例如，fontsize=12 将字体大小设置为 12 磅。在所有其他输入参数之后指定名称-值对组参数。并非所有图类型均支持修改标题外观。示例

t = title(___) 返回用于标题的对象。以后可以使用 t 修改标题。有关属性和说明的列表，请参阅 text 属性。

# 示例

在当前坐标区上添加标题

在当前坐标区中创建一个图窗并显示标题。

using TyBase
using TyPlot
plot((1:10).^2)
title("My Title")

您也可以通过可返回文本的函数来调用 title。例如，Dates 函数返回包含今日日期的文本。

dt = Dates.format(today(),"dd-uuu-yyyy")
title(dt)

Syslab 将 Dates 的输出设置为坐标区的标题。

在标题中包含变量的值

在标题中包含变量 c 的值。

using TyPlot
plot((1:10).^2)
f = 70;
c = (f-32)/1.8;
using Printf
str_c = @sprintf("%0.4f", c)
title("Temperature is "*str_c*" C")
使用Key=Value对组参数创建彩色标题

使用 Key=Value 对组 color="m" 将标题的颜色设置为品红色。

using TyPlot
plot((1:10).^2)
title("Case number # 3",color="m")
在标题中包含希腊符号

使用 TeX 标记在标题中包含希腊符号。

using TyPlot
t = (0:0.01:0.2);
y = exp.(-25*t);
plot(t,y)
title(raw"y = $e^{\lambda t}$"; color="b")
在标题中包含上标或下标字符
using TyPlot
plot((1:10).^2)
title(raw"$\alpha^2$ and $X_1$")

上标字符 “^” 和下标字符 “_” 可修改紧随其后的花括号中定义的字符或子字符串。

创建多行标题
using TyPlot
plot((1:10).^2)
title("First line\nSecond line")
按键入原样显示文本
using TyPlot
plot((1:10).^2)
title("X_1")
在特定的坐标区上添加标题

调用 subplot 函数以创建一个 2×1 分块图布局和一个坐标区对象，并将该对象返回为 ax1。通过将 ax1 传递给 plot 函数来创建顶部绘图。然后将数据绘制到每个坐标区中。

using TyPlot
subplot(2,1,1)
ax1 = subplot(2,1,1)
ax2 = subplot(2,1,2)

plot(ax1,(1:10).^2)
plot(ax2,(1:10).^3)

通过将 ax1 和 ax2 传递给 title 函数，为每个坐标区添加标题。

title(ax1,"Top Plot")
title(ax2,"Bottom Plot")
添加标题并返回文本句柄

在绘图上添加标题，并返回文本对象。

using TyPlot
plot((1:10).^2)
t = title("My Title");

将标题的颜色设置为红色。

t.set_color("red");
plt_update()

# 输入参数

txt - 要显示为标题的文本
字符串标量 | 数值

要显示为标题的文本，指定为字符串标量或数值。

示例： "my label"

示例： 123

要将数值变量和文本包括在标题中，请使用 string 函数。例如：

using Printf
using TyPlot
c = 36.5
str_c = @sprintf("%0.4f", c)
title("Temperature is "*str_c*" C")

要包括特殊字符（例如希腊字母或数学符号），请使用 TeX 标记。

要创建多行标题：

使用字符串，其中以"\n"表示换行，例如 "first line\nsecond line"。

使用 @sprintf("%g",value) 将数值型标题转换为文本。例如，12345678 显示为 1.23457e+07。

target - 标题的目标
坐标区 | 图例 | 图

要添加标题的目标对象，指定为以下项之一：

  • 任何类型的坐标区：Axes、PolarAxes对象；
  • Legend 对象；
  • 具有 Title 属性的图对象；
  • 由上述列表中的图形对象组成的数组。这些对象必须属于同一类。

如果不为标题指定目标，则 title 函数会将标题添加到由 gca 命令返回的图形对象。

注意

有些图不支持修改标题外观（例如颜色），或以输出参数形式返回文本对象。

# 名称-值对组参数

指定可选的、以逗号分隔的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。

示例： color="red" , fontsize=14 将添加一个红色、14 磅字体的标题。

除了以下属性之外，还可以使用 Key=Value 对组参数指定其他文本对象属性。请参见 text 属性。

fontsize - 字体大小
11 （默认） | 大于 0 的标量值

字体大小，指定为大于 0 的标量值（以磅为单位）。一磅等于 1/72 英寸。

如果您为坐标区对象添加标题，则坐标区的字体大小属性也会影响标题的字体大小。标题字体大小会更新为坐标区字体大小与标题缩放因子的乘积。坐标区的 fontsize 属性包含坐标区字体大小。默认情况下，坐标区的字体大小为 10 磅，缩放因子为 1.1，因此标题字体大小为 11 磅。

数据类型： Int16 | Int32 | Int64 | Float16 | Float32 | Float64

fontweight - 文本字符的粗细
"normal" （默认） | "bold"

文本字符的粗细，指定为下列值之一：

  • "bold" - 字符轮廓比普通粗；
  • "normal" - 由特定字体定义的普通粗细。

Syslab 使用 fontweight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能产生常规字体。

fontname - 字体名称
微软雅黑（默认）

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

color - 文本颜色
[0,0,0] （默认） | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

文本颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0,0,0] 对应于黑色。

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

  • RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]；
  • 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。

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

颜色名称 短名称 RGB 三元组 十六进制颜色代码 外观
"red" "r" [1, 0, 0] "#FF0000"
"green" 不适用 [0, 0.5019607843137255, 0] "#008000"
不适用 "g" [0, 0.5, 0] "#007F00"
不适用 不适用 [0, 1, 0] "#00FF00"
"blue" "b" [0, 0, 1] "#0000FF"
"cyan" 不适用 [0, 1, 1] "#00FFFF"
不适用 "c" [0, 0.75, 0.75] "#00BFBF"
"magenta" 不适用 [1, 0, 1] "#FF00FF"
不适用 "m" [0.75, 0, 0.75] "#BF00BF"
"yellow" 不适用 [1, 1, 0] "#FFFF00"
不适用 "y" [0.75, 0.75, 0] "#BFBF00"
"black" "k" [0, 0, 0] "#000000"
"white" "w" [1, 1, 1] "#FFFFFF"
"none" 不适用 不适用 不适用 无颜色

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

RGB 三元组 十六进制颜色代码 外观
[0, 0.4470, 0.7410] "#0072BD"
[0.8500, 0.3250, 0.0980] "#D95319"
[0.9290, 0.6940, 0.1250] "#EDB120"
[0.4940, 0.1840, 0.5560] "#7E2F8E"
[0.4660, 0.6740, 0.1880] "#77AC30"
[0.3010, 0.7450, 0.9330] "#4DBEEE"
[0.6350, 0.0780, 0.1840] "#A2142F"

示例： "blue"

示例： [0, 0, 1]

示例： "#0000FF"

# 输出参数

t - 用于标题文本的对象
文本对象

用于标题文本的对象，返回下列对象类型之一：

  • 文本对象 - 如果您为坐标区添加标题，title 将返回文本对象。创建标题后，可以使用此文本对象访问和修改标题属性。有关文本对象属性的列表，请参见 text 属性。您还可以通过坐标区对象的 title 属性访问标题；

  • 图例文本对象 - 如果您为图例添加标题，title 将返回图例文本对象。创建标题后，可以使用此图例文本对象访问和修改标题属性。有关图例文本对象属性的列表，请参见 text 属性。您还可以通过图例对象的 title 属性访问标题。

示例： 使用 plt_get 函数获取文本属性：

  • plt_get(t,"fontsize") 获取文本对象的字体大小；

  • plt_get(t,"color") 获取文本对象的颜色。

示例： 使用 plt_set 函数设置文本属性：

  • plt_set(t,"fontsize",18) 设置文本对象的字体大小；

  • plt_set(t,"color","r") 设置文本对象的颜色。

# 另请参阅

# 函数

text | xlabel | ylabel | zlabel | legend

# 属性

text 属性