TextBox Properties

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

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

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

t = annotation('textbox');
sz = t.FontSize;
t.FontSize = 12;

Если вы используете более раннюю версию, используйте вместо этого функции get и set.

Текст

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

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

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

Пример: 'my label'

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

Пример: {'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^® использует значения в массиве, не категории.

`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'

`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/.

Шрифт

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

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

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

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

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

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

Пример: 12

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

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

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

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

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

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

`'FontUnits'` Модули размера шрифта
`'points'` (значение по умолчанию) | `'inches'` | `'centimeters'` | `'normalized'` | `'pixels'`

Модули размера шрифта, заданные как одно из значений в этой таблице.

`Units`	Описание
`'points'`	'points'. Один пункт равен 1/72 дюйма.
`'inches'`	'inches'.
`'centimeters'`	'centimeters'.
`'normalized'`	Интерпретируйте размер шрифта как часть высоты родительского контейнера, обычно фигура. Если вы изменяете размер контейнера, размер шрифта изменяет соответственно. Например, если `FontSize` является `0.1` в нормированных единицах, то текст является 1/10 контейнерной высоты.
`'pixels'`	'pixels'. Начиная с версии R2015b, значения размеров в пикселях не зависят от вашего системного разрешения в системах Windows^® и Macintosh: В системах Windows пиксель составляет 1/72 дюйма. В системах Macintosh пиксель составляет 1/72 дюйма. В системах Linux^® размер пикселя определяется вашим системным разрешением.

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

Текстовое поле

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

`FitBoxToText` Опция, чтобы соответствовать полю width и высоте к тексту
`'on'` (значение по умолчанию) | `'off'`

Опция, чтобы соответствовать полю width и высоте к тексту, заданному как одно из этих значений:

'on' — Измените размер текстового поля, чтобы соответствовать тексту.
'off' Перенесите текст, чтобы соответствовать ширине текстового поля. Перенос может заставить часть текста расширять ниже текстового поля.

Если вы изменяете размер текстового поля, когда в режиме редактирования графика, или если вы изменяете свойство Position, то изменения свойства FitBoxToText в 'off'.

`'EdgeColor'` Цвет схемы поля
`[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	Шестнадцатеричный цветовой код	Внешний вид
`'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	Шестнадцатеричный цветовой код	Внешний вид
[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'

`BackgroundColor` Цвет фона текстового поля
`'none'` (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` |...

Цвет фона текстового поля, заданного как триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7].
Шестнадцатеричный цветовой код является вектором символов или скаляром строки, который запускается с символа хеша (#), сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут колебаться от 0 до F. Значения не являются чувствительными к регистру. Таким образом цветовые коды '#FF8800', '#ff8800', '#F80' и '#f80' эквивалентны.

Название цвета	Краткое название	Триплет 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	Шестнадцатеричный цветовой код	Внешний вид
[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'

`'FaceAlpha'` Прозрачность цвета фона
`1` (значение по умолчанию) | скалярное значение между 0 и 1 включительно

Прозрачность цвета фона, заданного как скалярное значение между 0 и 1. Если значение равняется 1, то цвет непрозрачен. Чтобы добавить прозрачность, установите свойство на значение ближе к 0, где 0 абсолютно прозрачно.

`LineStyle` — Стиль линии схемы поля
`'-'` (значение по умолчанию) | `'--'` | `':'` | `'-.'` | `'none'`

Стиль линии схемы поля, заданной как одна из опций, перечислен в этой таблице.

Стиль линии	Описание
`'-'`	Сплошная линия
`'--'`	Пунктирная линия
`':'`	Пунктирная линия
`'-.'`	Штрих-пунктирная линия
`'none'`	Схема поля невидима

`'LineWidth'` Ширина схемы поля
`0.5` (значение по умолчанию) | скалярное числовое значение

Ширина схемы поля, заданной как скалярное числовое значение в модулях точки. Один пункт равен 1/72 дюйма.

Пример: 1.5

`Margin` — Пробел вокруг текста в текстовом поле
`5` (значение по умолчанию) | скалярное числовое значение

Пробел вокруг текста в текстовом поле, заданном как скалярное числовое значение в пиксельных модулях.

Положение

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

`Position` — Размер и местоположение
`[0.3 0.3 0.1 0.1]` (значение по умолчанию) | четырехэлементный вектор

Размер и местоположение, заданное как четырехэлементный вектор формы [x_begin y_begin length height]. Первые два элемента задают координаты для нижнего левого угла текстового поля. Вторые два элемента задают длину и высоту текстового поля.

По умолчанию модули нормированы фигуре. Нижний левый угол фигуры сопоставляет с (0,0), и верхний правый угол сопоставляет с (1,1). Для изменения единиц используйте свойство Units.