Text Properties

Внешний вид и поведение текста легенды

Свойства текста легенды управляют внешним видом и поведением заголовка легенды. Путем изменения значений свойств можно изменить определенные аспекты заголовка. Используйте запись через точку для ссылки на конкретный объект и свойство:

l = legend('show');
l.Title.String = 'My Title';
l.Title.Color = 'red';
c = l.Title.Color

Текст

развернуть все

`Строка` Текст, чтобы отобразиться как заголовок
символьный массив | массив строк | массив ячеек | категориальный массив | числовое значение

Текст, чтобы отобразиться как заголовок, заданный как символьный массив, массив строк, массив ячеек, категориальный массив или числовое значение.

Пример: 'my title'

Пример: string('my title')

Пример: {'first line','second line'}

Пример: 123

Чтобы включать числовые переменные с текстом в заголовке, используйте функцию num2str. Например:

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

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

Создать многострочные заголовки:

Используйте массив строк, где каждый элемент содержит строку текста, такого как string({'line one','line two'}).
Используйте массив ячеек, где каждая ячейка содержит строку текста, такого как {'first line','second line'}.
Используйте символьный массив, где каждая строка содержит строку текста, такого как ['abc'; 'ab ']. Если вы используете этот метод, каждая строка должна содержать то же количество символов.
Используйте sprintf, чтобы создать текст с символом новой строки, таким как sprintf('first line \n second line').

Числовые заголовки преобразованы в текст с помощью sprintf('%g',value). Например, 12345678 отображается как 1.23457e+07.

Примечание

default слов, factory и remove являются зарезервированными словами, которые не появятся в заголовке, когда заключено в кавычки как вектор обычного символа. Чтобы отобразить любое из этих слов индивидуально, предшествуйте им с наклонной чертой влево, такой как '\default' или '\remove'.
Если вы задаете это свойство как категориальный массив, MATLAB^® использует значения в массиве, не категории.

`Interpreter` — Интерпретация текстовых символов
`'tex'` (значение по умолчанию) | `'latex'` | `'none'`

Интерпретация текстовых символов, заданных как одно из этих значений:

'tex' — Интерпретируйте символы с помощью подмножества разметки TeX.
'latex' — Интерпретируйте символы, использующие разметку LATEX.
'none' Отобразите буквенные символы.

TeX Markup

По умолчанию MATLAB поддерживает подмножество разметки TeX. Используйте синтаксис TeX, чтобы добавить верхние индексы и индексы, изменить тип шрифта и окрасить и включать специальные символы в текст.

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете свойство Interpreter на 'tex', поддерживаемые модификаторы следующие.

Модификатор	Описание	Пример
`^{ }`	Верхний индекс	`'text^{superscript}'`
`_{ }`	Индекс	`'text_{subscript}'`
`\bf`	Bold font	`'\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` с одним из этих цветов: `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'`

В этой таблице перечислены поддерживаемые специальные символы со свойством Interpreter, установленным на '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, установите свойство Interpreter на 'latex'. Используйте долларовые символы вокруг текста, например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

Отображаемый текст использует стиль шрифта LATEX по умолчанию. FontName, FontWeight и свойства FontAngle не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LATEX.

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

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

`InterpreterMode` Режим выбора для `Interpreter`
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для свойства Interpreter, заданного как одно из этих значений:

'auto' Используйте то же значение в качестве свойства Interpreter для связанного объекта Legend.
'manual' — Используйте значение Interpreter, который вы задаете. Чтобы задать значение, установите свойство Interpreter. Когда вы устанавливаете свойство Interpreter, свойство InterpreterMode изменяется на 'manual'.

Стиль шрифта и внешний вид

развернуть все

`Color` — TextColor
`[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'`	`'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'

`ColorMode` Режим выбора для `Color`
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для свойства Color, заданного как одно из этих значений:

'auto' Используйте то же значение в качестве свойства TextColor для связанного объекта Legend.
'manual' — Используйте значение Color, который вы задаете. Чтобы задать значение, установите свойство Color. Когда вы устанавливаете свойство Color, свойство ColorMode изменяется на 'manual'.

`FontAngle` Символьный наклон
`'normal'` (значение по умолчанию) | `'italic'`

Наклонные символы, заданные как 'normal' или 'italic'.

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

`FontAngleMode` Режим выбора для `FontAngle`
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для свойства FontAngle, заданного как одно из этих значений:

'auto' Используйте то же значение в качестве свойства FontAngle для связанного объекта Legend.
'manual' — Используйте значение FontAngle, который вы задаете. Чтобы задать значение, установите свойство FontAngle. Когда вы устанавливаете свойство FontAngle, свойство FontAngleMode изменяется на 'manual'.

`FontName` FontName
поддерживаемое название шрифта | `'FixedWidth'`

Название шрифта, заданное как поддерживаемое название шрифта или 'FixedWidth'. Чтобы отобразить и распечатать текст правильно, необходимо выбрать шрифт, который поддерживает система. Стандартный шрифт зависит от вашей операционной системы и локали.

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

`FontNameMode` Режим выбора для `FontName`
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для свойства FontName, заданного как одно из этих значений:

'auto' Используйте то же значение в качестве свойства FontName для связанного объекта Legend.
'manual' — Используйте значение FontName, который вы задаете. Чтобы задать значение, установите свойство FontName. Когда вы устанавливаете свойство FontName, свойство FontNameMode изменяется на 'manual'.

`'FontSize'` 'FontSize'
скалярное значение, больше, чем нуль

Размер шрифта, заданный как скалярное значение, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали.

Если вы изменяете размер шрифта осей, то MATLAB автоматически устанавливает размер шрифта шкалы палитры к 90% размера шрифта осей. Если вы вручную устанавливаете размер шрифта шкалы палитры, то изменение размера шрифта осей не влияет на шрифт шкалы палитры.

`FontSizeMode` Режим выбора для `FontSize`
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для свойства FontSize, заданного как одно из этих значений:

'auto' Используйте то же значение в качестве свойства FontSize для связанного объекта Legend.
'manual' — Используйте значение FontSize, который вы задаете. Чтобы задать значение, установите свойство FontSize. Когда вы устанавливаете свойство FontSize, свойство FontSizeMode изменяется на 'manual'.

`FontWeight` Символьная толщина
`'normal'` (значение по умолчанию) | `'bold'`

Символьная толщина, заданная как 'normal' или 'bold'.

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

`FontWeightMode` Режим выбора для `FontWeight`
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для свойства FontWeight, заданного как одно из этих значений:

'auto' Используйте то же значение в качестве свойства FontWeight для связанного объекта Legend.
'manual' — Используйте значение FontWeight, который вы задаете. Чтобы задать значение, установите свойство FontWeight. Когда вы устанавливаете свойство FontWeight, свойство FontWeightMode изменяется на 'manual'.

`Visible` — Состояние видимости
`'on'` (значение по умолчанию) | `'off'`

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

'on' — Отображать объект.
'off' — Скрыть объект, не удаляя его. Вы по-прежнему можете получать доступ к свойствам невидимого объекта.

Смотрите также

legend | title

Документация

Text Properties

Текст