TextBox Properties

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

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

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

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

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

Текст

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

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

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

Внешний вид текста	Описание значения	Пример
Одна линия текста	Вектор символов или массив строк 1 на 1.	str = 'My Text' или str = "My Text"
Несколько линий текста	Массив ячеек из символьных векторов или массив строк.	str = {'First line','Second line'}; или str = ["First line", "Second line"];
Текст, который включает числовую переменную	Массив, который включает номер, преобразованный в `char` массив. Используйте `num2str` преобразовывать значение.	x = 42; str = ['The value is ',num2str(x)];
Текст, который включает специальные символы, такие как греческие буквы или математические символы	Массив, который включает разметку TeX. Для списка поддерживаемой разметки смотрите `Interpreter` свойство.	str = 'x ranges from 0 to 2\pi'

Примечание

Слова defaultФабрика, и remove зарезервированные слова, которые не появляются в тексте, когда заключено в кавычки как обычные символы. Чтобы отобразить любое из этих слов индивидуально, предшествуйте им с обратной косой чертой, такой как '\default' или '\remove'.
Если вы задаете это свойство как категориальный массив, MATLAB^® использует значения в массиве, не категории.
Если вы задаете текст, который содержит только числовое значение, значение преобразовано с помощью sprintf('%g',value). Например, 12345678 отображения как 1.23457e+07.

`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Пурпурный`, `blue`, `black`, `whiteсерый`, `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 по умолчанию. FontNameFontWeight , и 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 свойство.