gtext

Добавление текста, чтобы фигурировать Используя мышь

Синтаксис

gtext(str)
gtext(str,Name,Value)
t = gtext(___)

Описание

пример

gtext(str) вставляет текст, str, в местоположении, которое вы выбираете с мышью. Когда вы нависаете над окном фигуры, указатель становится перекрестием. gtext ожидает вас, чтобы выбрать местоположение. Переместите указатель на местоположение, вы хотите и или кликаете по фигуре или нажимаете любую клавишу, кроме Входят.

gtext(str,Name,Value) задает текстовые свойства с помощью одного или нескольких аргументов в виде пар "имя-значение". Например, 'FontSize',14 задает шрифт с 14 точками.

t = gtext(___) возвращает массив текстовых объектов, созданных gtext. Используйте t, чтобы изменить свойства текстовых объектов после того, как они будут созданы. Для списка свойств и описаний, смотрите Text Properties. Можно возвратить выходной аргумент с помощью любого из аргументов от предыдущих синтаксисов.

Примеры

свернуть все

Постройте простой график и используйте gtext, чтобы добавить текст к фигуре, использующей мышь.

plot(1:10)
gtext('My Plot')

Кликните по фигуре, чтобы поместить текст в выбранном местоположении.

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

plot(1:10)
gtext('My Plot','Color','red','FontSize',14)

Кликните по фигуре, где вы хотите отобразить текст.

Постройте простой график и добавьте текст к фигуре, использующей мышь. Возвратите созданный текстовый объект, t.

plot(1:10)
t = gtext('My Plot')

Кликните по фигуре, чтобы поместить текст и создать текстовый объект.

t = 

  Text (My Plot) with properties:

                 String: 'My Plot'
               FontSize: 10
             FontWeight: 'normal'
               FontName: 'Helvetica'
                  Color: [0 0 0]
    HorizontalAlignment: 'left'
               Position: [4.3906 5.3950 0]
                  Units: 'data'

  Show all properties

Используйте t, чтобы изменить размер шрифта и цвет текста путем установки текстовых свойств. Начиная с R2014b, вы можете использовать запись через точку для того, чтобы задать свойства. При использовании более ранний релиз, используйте функцию set вместо этого, такую как set(t,'Color','red').

t.Color = 'red';
t.FontSize = 14;

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

свернуть все

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

  • Вектор символа — Отображение текст одним нажатием кнопки, например:

    gtext('my text')

  • Массив ячеек из символьных векторов Отобразите одну строку массива каждым нажатием кнопки. Например, этот код отображает first первым нажатием кнопки и second вторым нажатием кнопки.

    gtext({'first';'second'})

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

    gtext({'first','new line';'second','new line'})

  • Символьный массив — Отображение одна строка массива каждым нажатием кнопки. Каждая строка должна содержать то же количество символов, например:

    gtext(['one';'two'])

  • Массив строк — Отображение одна строка массива каждым нажатием кнопки. Например:

    gtext(["one";"two"])

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

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: текст. 5.5, 'мой текст', 'FontSize', 14, 'Цвет', 'красный')

Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите Text Properties.

Примечание

Вы не можете задать текстовое свойство Position как пару "имя-значение" во время текстового создания. gtext игнорирует заданное значение.

Размер шрифта, заданный как скалярное значение, больше, чем нуль в модулях точки. The default font size depends on the specific operating system and locale. One point equals 1/72 inch., Чтобы изменить модули шрифта, используйте свойство FontUnits.

Пример: 12

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

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

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

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

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

Цвет текста, заданный как триплет RGB или один из перечисленных в таблице параметров цвета. Значение по умолчанию [0 0 0] соответствует черный.

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

ОпцияОписаниеЭквивалентный триплет RGB
'красный' или 'r'Красный[1 0 0]
'green' или 'g'Зеленый[0 1 0]
'blue' или 'b'Синий[0 0 1]
'yellow' или 'y'Желтый[1 1 0]
'пурпурный' или 'm'Пурпурный[1 0 1]
'голубой' или 'c'Голубой[0 1 1]
'white' или 'w'Белый[1 1 1]
'black' или 'k'Черный[0 0 0]
'none'Нет цветаНе применяется

Пример: 'blue'

Пример: [0 0 1]

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

ЗначениеРезультат
'left' (значение по умолчанию)

центр

'right'

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

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

  • 'latex' — Интерпретируйте символы, использующие разметку LATEX.

  • 'none' Отобразите буквенные символы.

TeX Markup

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

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

МодификаторОписаниеПример
^{ }Верхний индексtext^{superscript}
_{ }Индексtext_{subscript}
\bfBold 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/.

Алгоритмы

gtext использует функции text и ginput.

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

Была ли эта тема полезной?