Main Content

sgtitle

向绘图的网格添加标题

全页折叠

语法

sgtitle(txt)
sgtitle(target,txt)
sgtitle(___,Name,Value)
sgt = sgtitle(___)

说明

示例

sgtitle(txt) 在当前图窗中子图的网格上方添加标题。如果图窗不存在，则此命令会创建一个图窗。

sgtitle(target,txt) 将标题添加到指定的图窗、面板或选项卡（而不是当前图窗）中的子图网格。

sgtitle(___,Name,Value) 使用一个或多个名称-值对组参量修改文本属性。例如，'FontSize',12 指定 12 磅字体。有关属性列表，请参阅 Text 属性。在所有其他输入参量之后指定名称-值对组参量。

sgt = sgtitle(___) 返回用于创建标题的子图 Text 对象。

示例

全部折叠

创建带有四个子图的图窗。为每个子图添加标题，然后将总标题添加到子图网格中。

subplot(2,2,1)
title('First Subplot')
subplot(2,2,2)
title('Second Subplot')
subplot(2,2,3)
title('Third Subplot')
subplot(2,2,4)
title('Fourth Subplot')

sgtitle('Subplot Grid Title')

Four axes in a figure that each have a title. An overall title is displayed at the top of the figure.

通过设置属性来修改标题外观，首先使用名称-值对组参量，然后返回创建的 Text 对象并使用圆点表示法。

使用名称-值对组参量更改 Color 属性。接下来，使用圆点表示法更改 FontSize 属性。

subplot(2,1,1)
title('First Subplot')
subplot(2,1,2)
title('Second Subplot')

sgt = sgtitle('Subplot Grid Title','Color','red');
sgt.FontSize = 20;

Two axes in a figure that each have a title. A red, larger title is displayed at the top of the figure.

输入参数

全部折叠

要显示的文本，指定为字符向量、字符向量元胞数组、字符串数组或数值。

示例: 'my label'

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

示例: string('my label')

示例: 123

要包括数值变量和文本，请使用 num2str 函数。例如：

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

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

要创建多行文本，请使用以下约定：

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

  • 使用字符串数组，其中每个元素包含一行文本，例如 string({'line one','line two'})。

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

  • 使用 sprintf 创建包含换行符的文本，例如 sprintf('first line \n second line')。此属性将包含换行符的文本转换为元胞数组。

如果文本仅包含一个数值，则它是使用 sprintf('%g',value) 进行转换的。例如，12345678 显示为 1.23457e+07。

子图网格容器，指定为 Figure、Panel 或 Tab 对象。

名称-值参数

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

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

示例: sgtitle('My Title','FontSize',14)

注意

此处所列的属性只是一部分。有关完整列表，请参阅 Text 属性。

字体大小，指定为大于 0 的标量值（以磅为单位）。默认字体大小取决于具体操作系统和区域设置。一磅等于 1/72 英寸。要更改字体单位，请使用 FontUnits 属性。

示例: 12

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

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

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

版本历史记录

在 R2018b 中推出

另请参阅

函数

属性