title

Добавить заголовок

Описание

пример

title(titletext) добавляет указанный заголовок к текущей системе координат или автономной визуализации. Переиздание title команда заставляет новый заголовок заменить старый заголовок.

пример

title(titletext,subtitletext) добавляет подзаголовок под заголовком.

пример

title(___,Name,Value) изменяет внешний вид заголовка с помощью одного или нескольких аргументов пары "имя-значение". Для примера, 'FontSize',12 устанавливает размер шрифта равным 12 точкам. Задайте аргументы пары "имя-значение" после всех других входных параметров. Изменение внешнего вида заголовка не поддерживается для всех типов графиков.

пример

title(target,___) добавляет заголовок к указанному целевому объекту.

пример

t = title(___) возвращает объект, используемый для заголовка. Использование t для внесения будущих изменений в заголовок.

пример

[t,s] = title(___) возвращает объекты, используемые для заголовка и субтитра. Использование t для изменения заголовка и использования s для изменения субтитра.

Примеры

свернуть все

Создать рисунок и отобразить заголовок в текущей системе координат.

plot((1:10).^2)
title('My Title')

Figure contains an axes. The axes with title My Title contains an object of type line.

Можно также вызвать функцию title с функцией, которая возвращает текст. Для примера, date функция возвращает текст с текущей датой.

title(date)

Figure contains an axes. The axes with title 23-Mar-2021 contains an object of type line.

MATLAB ® устанавливает выходные данные date как заголовок осей.

Создать график. Затем создайте заголовок и подзаголовок, позвонив в title функция с двумя векторами символов в качестве аргументов. Используйте 'Color' аргумент пары "имя-значение" для настройки цвета для обеих линий текста. Задайте два возвращаемых аргументов для хранения текстовых объектов для заголовка и субтитра.

plot([0 1])
[t,s] = title('Straight Line','Slope = 1, y-Intercept = 0','Color','blue');

Figure contains an axes. The axes with title Straight Line contains an object of type line.

Измените размер шрифта для заголовка на 16, и измените угол шрифта для субтитра на 'italic'.

t.FontSize = 16;
s.FontAngle = 'italic';

Figure contains an axes. The axes with title Straight Line contains an object of type line.

Включите значение переменной c в заголовке.

figure
plot((1:10).^2)
f = 70;
c = (f-32)/1.8;
title(['Temperature is ',num2str(c),' C'])

Figure contains an axes. The axes with title Temperature is 21.1111 C contains an object of type line.

Используйте модификатор цвета \color чтобы изменить цвет символов, следующих за ним с предыдущего цвета.

plot((1:10).^2)
title(['\fontsize{16}black {\color{magenta}magenta '...
'\color[rgb]{0 .5 .5}teal \color{red}red} black again'])

Figure contains an axes. The axes with title \fontsize{16}black {\color{magenta}magenta \color[rgb]{0 .5 .5}teal \color{red}red} black again contains an object of type line.

Создать график и определить t как вектор символов, который включает разметку LaTeX. Окружите разметку знаками доллара ($). Затем передайте t на title function, и установите Interpreter свойство к 'latex'.

x = 0:0.1:10;
y = sin(x);
dy = cos(x);
plot(x,y,x,dy);
t = '$sin(x)$ and $\frac{d}{dx}sin(x)$';
title(t,'interpreter','latex')

Figure contains an axes. The axes with title $sin(x)$ and $\frac{d}{dx}sin(x)$ contains 2 objects of type line.

Используйте Name,Value парные 'Color','m' для установки цвета заголовка на пурпурный.

figure
plot((1:10).^2)
title('Case number # 3','Color', 'm')

Figure contains an axes. The axes with title Case number # 3 contains an object of type line.

Используйте разметку TeX, чтобы включить греческие символы в заголовок.

t = (0:0.01:0.2);
y = exp(-25*t);
figure
plot(t,y)
title('y = \ite^{\lambda t}','Color','b')

Figure contains an axes. The axes with title y = \ite^{\lambda t} contains an object of type line.

The 'Interpreter' свойство должно быть 'tex' (значение по умолчанию).

figure
plot((1:10).^2)
title('\alpha^2 and X_1')

Figure contains an axes. The axes with title \alpha^2 and X_1 contains an object of type line.

Символ верхнего индекса, «^», и нижний символ, «_», изменяет символ или подстроку, определенную в фигурных скобках сразу после.

Создайте заголовок мультилинии с помощью массива многолинейных ячеек.

figure
plot((1:10).^2)
title({'First line';'Second line'})

Figure contains an axes. The axes with title First line Second line contains an object of type line.

Установите Interpreter свойство как 'none' так что текст X_1 отображается на рисунке как набранный, не делая 1 индекс X.

plot((1:10).^2)
title('X_1','Interpreter','none')

Figure contains an axes. The axes with title X_1 contains an object of type line.

Начиная с R2019b, можно отобразить плиточное размещение графиков с помощью tiledlayout и nexttile функций. Вызовите tiledlayout функция для создания мозаичного графика размещения 2 на 1. Вызовите nexttile функция для создания объектов осей ax1 и ax2. Затем постройте график данных для каждой оси.

tiledlayout(2,1)
ax1 = nexttile;
plot(ax1,(1:10).^2)
ax2 = nexttile;
plot(ax2,(1:10).^3)

Figure contains 2 axes. Axes 1 contains an object of type line. Axes 2 contains an object of type line.

Добавить заголовок каждой оси путем передачи ax1 и ax2 на title функция.

title(ax1,'Top Plot')
title(ax2,'Bottom Plot')

Figure contains 2 axes. Axes 1 with title Top Plot contains an object of type line. Axes 2 with title Bottom Plot contains an object of type line.

Добавить заголовок к графику и вернуть текстовый объект.

plot((1:10).^2)
t = title('My Title');

Figure contains an axes. The axes with title My Title contains an object of type line.

Установите красный цвет заголовка. Используйте запись через точку для того, чтобы задать свойства.

t.Color = 'red';

Figure contains an axes. The axes with title My Title contains an object of type line.

Создать график с заголовком. Получите текущие системы координат, а затем выровняйте заголовок по левому краю графика путем установки TitleHorizontalAlignment свойство осей, чтобы 'left'.

plot([0 2],[1 5])
title('Straight Line')
ax = gca;
ax.TitleHorizontalAlignment = 'left';

Figure contains an axes. The axes with title Straight Line contains an object of type line.

Центрируйте заголовок, устанавливая TitleHorizontalAlignment свойство на осях к 'center'.

ax.TitleHorizontalAlignment = 'center';

Figure contains an axes. The axes with title Straight Line contains an object of type line.

Входные параметры

свернуть все

Заглавный текст, заданный как вектор символов, массив ячеек из векторов символов, строковые массивы, категориальный массив или числовое значение. Задайте значение в зависимости от способа отображения текста. В этой таблице перечислены наиболее распространенные ситуации.

Внешний вид текстаОписание значенияПример
Одна линия текста Вектор символов или строковый скаляр.

txt = 'My Text'
или
txt = "My Text"

Несколько линии текстаМассив ячеек из символьных векторов или строковых массивов.

txt = {'First line','Second line'};
или
txt = ["First line", "Second line"];

Текст, который включает числовую переменнуюМассив, который включает число, преобразованное в char массив. Использовать num2str для преобразования значения.

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

Текст, который включает специальные символы, такие как греческие буквы или математические символыМассив, который включает разметку TeX. Список поддерживаемых разметок см. в Interpreter свойство.

txt = 'x ranges from 0 to 2\pi'

Примечание

  • Слова default, factory, и remove являются зарезервированными словами, которые не отображаются в тексте, если цитируются как обычные символы. Чтобы отобразить любое из этих слов по отдельности, предшествуйте им с обратной косой чертой, такой как '\default' или '\remove'.

  • Если вы задаете это свойство как категориальный массив, MATLAB® использует значения в массиве, а не категории.

  • Если вы задаете текст, который содержит только числовое значение, значение преобразуется с помощью sprintf('%g',value). Для примера, 12345678 отображается следующим 1.23457e+07.

Текст субтитра, заданный как вектор символов, массив ячеек из векторов символов, строковые массивы, категориальный массив или числовое значение. Задайте значение в зависимости от способа отображения текста. В этой таблице перечислены наиболее распространенные ситуации.

Внешний вид текстаОписание значенияПример
Одна линия текста Вектор символов или строковый скаляр.

txt = 'My Text'
или
txt = "My Text"

Несколько линии текстаМассив ячеек из символьных векторов или строковых массивов.

txt = {'First line','Second line'};
или
txt = ["First line", "Second line"];

Текст, который включает числовую переменнуюМассив, который включает число, преобразованное в char массив. Использовать num2str для преобразования значения.

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

Текст, который включает специальные символы, такие как греческие буквы или математические символыМассив, который включает разметку TeX. Список поддерживаемых разметок см. в Interpreter свойство.

txt = 'x ranges from 0 to 2\pi'

Примечание

  • Слова default, factory, и remove являются зарезервированными словами, которые не отображаются в тексте, если цитируются как обычные символы. Чтобы отобразить любое из этих слов по отдельности, предшествуйте им с обратной косой чертой, такой как '\default' или '\remove'.

  • Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, а не категории.

  • Если вы задаете текст, который содержит только числовое значение, значение преобразуется с помощью sprintf('%g',value). Для примера, 12345678 отображается следующим 1.23457e+07.

Цель для заголовка, заданная как одно из следующего:

  • Любой тип осей: Axes, PolarAxes, или GeographicAxes объект.

  • Любой тип легенды: a Legend или BubbleLegendобъект.

  • A TiledChartLayout объект.

  • Автономная визуализация, которая имеет Title свойство. Для примера можно добавить заголовок в HeatmapChart объект.

  • Массив графических объектов из предыдущего списка. Объекты должны принадлежать одному и тому же классу. Чтобы определить класс, используйте class функция.

Если вы не задаете цель для заголовка, то title функция добавляет заголовок к графическому объекту, возвращаемому gca команда.

Примечание

Некоторые графики не поддерживают изменение внешнего вида заголовка, например, цвета, или возврат текстового объекта в качестве выходного аргумента.

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'Color','red','FontSize',14 добавляет заголовок с красным шрифтом с 14 точками.

В дополнение к следующему можно задать другие свойства текстовых объектов с помощью Name,Value аргументы в виде пар. См. раздел Text Свойств.

Размер шрифта, заданный как скалярное значение, больше 0 в точке модулей. Одна точка равна 1/72 дюйма. Для изменения модулей шрифта используйте FontUnits свойство.

Если вы добавляете заголовок или субтитр к объекту осей, свойство font size для осей также влияет на размер шрифта для title и субтитра. Размеры заголовка и шрифта субтитров являются размером шрифта осей, умноженным на шкалу множитель. The FontSize свойство осей содержит размер шрифта осей. The TitleFontSizeMultiplier свойство осей содержит коэффициент шкалы. По умолчанию размер шрифта осей составляет 10 точки, а масштабный коэффициент равен 1,1, поэтому заголовок и субтитр каждый имеют размер шрифта 11 точек.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Толщина текстовых символов, заданная как одно из следующих значений:

  • 'normal' - Нормальный вес, определяемый конкретным шрифтом

  • 'bold' - более тонкие контуры символов, чем обычно

MATLAB использует FontWeight свойство для выбора шрифта из доступных в вашей системе. Не все шрифты имеют полужирный шрифт вес. Поэтому установка полужирного шрифта веса все еще может привести к нормальной толщине шрифта.

The TitleFontWeight свойство для связанных осей влияет на FontWeight значение для заголовка. Точно так же SubtitleFontWeight свойство для связанных осей влияет на FontWeight значение для субтитра.

Примечание

The 'light' и 'demi' значения толщины шрифта были удалены. Использование 'normal' вместо этого.

Название шрифта, заданное как поддерживаемое название шрифта шрифта или 'FixedWidth'. Для правильного отображения и печати текста необходимо выбрать шрифт, поддерживаемый системой. Шрифт по умолчанию зависит от операционной системы и локали.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любой локали, используйте 'FixedWidth'. Шрифт фиксированной ширины опирается на корень FixedWidthFontName свойство. Установка корневого FixedWidthFontName свойство приводит к немедленному обновлению отображения, чтобы использовать новый шрифт.

Цвет текста, заданный как триплет 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''g'[0 1 0]'#00FF00'

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

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

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

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

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'Не применяетсяНе применяетсяНе применяетсяНет цвета

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Триплет 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'

Текстовый интерпретатор, заданный в качестве одного из следующих значений:

  • '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'
\ цвет {specifier}Цвет шрифта - Заменить specifier с одним из следующих цветов: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, или lightBlue.'\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 по умолчанию. The FontName, FontWeight, и FontAngle свойства не имеют эффекта. Для изменения стиля шрифта используйте разметку LaTeX.

Максимальный размер текста, который можно использовать с интерпретатором LaTeX, составляет 1200 символов. Для многострочного текста это уменьшается примерно на 10 символов на линию.

Для примеров, которые используют TeX и LaTeX, смотрите греческие буквы и специальные символы в тексте графика. Для получения дополнительной информации о системе LaTeX, смотрите веб-сайт проекта LaTeX в https://www.latex-project.org/.

Выходные аргументы

свернуть все

Объект, используемый для заголовка, возвращенный как один из следующих типов объектов:

  • Текстовый объект - Если вы добавляете заголовок к осям, то title возвращает текстовый объект. Используйте этот текстовый объект для доступа и изменения свойств заголовка после его создания. Список свойств текстовых объектов см. в разделе Свойства текста. Вы также можете получить доступ к заголовку через Title свойство объекта осей.

  • Текстовый объект Legend - Если вы добавляете заголовок в легенду, то title возвращает текстовый объект легенды. Используйте этот текстовый объект легенды для доступа и изменения свойств заголовка после его создания. Список свойств текстовых объектов легенды см. в разделе Свойства текста. Вы также можете получить доступ к заголовку через Title свойство объекта legend.

Объект, используемый для субтитра, возвращается как текстовый объект. Используйте этот текстовый объект для изменения свойств субтитра после его создания. Список свойств текстовых объектов см. в разделе Свойства текста. Вы также можете получить доступ к субтитру через Subtitle свойство объекта осей.

Представлено до R2006a