Текстовый внешний вид и поведение
Свойства Text
управляют внешним видом и поведением объекта Text
. Путем изменения значений свойств можно изменить определенные аспекты текста.
Начиная с R2014b, вы можете использовать запись через точку для того, чтобы запросить и задать свойства.
t = text(0.5,0.5,'text here'); s = 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'
Отобразите буквенные символы.
По умолчанию MATLAB поддерживает подмножество разметки TeX. Используйте синтаксис TeX, чтобы добавить верхние индексы и индексы, изменить тип шрифта и окрасить и включать специальные символы в текст.
Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете свойство Interpreter
на 'tex'
, поддерживаемые модификаторы следующие.
Модификатор | Описание | Пример |
---|---|---|
^{ } | Верхний индекс | 'text^{superscript}' |
_{ } | Индекс | 'text_{subscript}' |
\bf | Bold font | '\bf text' |
\it | Курсивный шрифт | '\it text' |
\sl | Наклонный шрифт (обычно то же самое как курсивный шрифт) | '\sl text' |
\rm | Обычный шрифт | '\rm text' |
| Название шрифта — Замена с именем семейства шрифтов. Можно использовать это в сочетании с другими модификаторами. | '\fontname{Courier} text' |
| Размер шрифта — Замена со значением числового скаляра в модулях точки. | '\fontsize{15} text' |
| Цвет шрифта — Замена с одним из этих цветов: red , green , yellow , magenta , blue , black , white , gray , darkGreen , orange или lightBlue . | '\color{magenta} text' |
\color[rgb]{specifier} | Цвет пользовательского шрифта — Замена с трехэлементным триплетом RGB. | '\color[rgb]{0,0.5,0.5} text' |
В этой таблице перечислены поддерживаемые специальные символы со свойством Interpreter, установленным на 'tex'.
Последовательность символов | Символ | Последовательность символов | Символ | Последовательность символов | Символ |
---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
|
| ≤ | |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ | \0 | ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
Чтобы использовать разметку 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' Размер шрифта, заданный как скалярное значение, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Один пункт равен 1/72 дюйма.
Чтобы изменить модули шрифта, используйте свойство FontUnits
.
Пример: 12
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
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:
В системах Linux® размер пикселя определяется вашим системным разрешением. |
Если вы устанавливаете и размер шрифта и модули шрифта в одном вызове функции, необходимо установить свойство FontUnits
сначала так, чтобы оси правильно интерпретировали заданный размер шрифта.
FontSmoothing
Сглаженный внешний вид символа шрифта'on'
(значение по умолчанию) | 'off'
Сглаженный внешний вид символа шрифта, заданный как одно из этих значений:
'on'
— Примените сглаживание шрифта. Уменьшайте внешний вид зубчатости в текстовых символах, чтобы сделать текст легче читать.
'off'
Не применяйте сглаживание шрифта.
Вращение
Текстовая ориентация0
(значение по умолчанию) | скалярное значение в градусахТекстовая ориентация, заданная как скалярное значение в градусах. Вращение по умолчанию 0 градусов делает текстовую горизонталь. Для вертикального текста, набор это свойство к 90
или -90
. Положительные значения вращают текст против часовой стрелки. Отрицательные величины вращают текст по часовой стрелке.
Пример: 90
Пример: -90
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
'EdgeColor'
Цвет схемы поля'none'
(значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r'
| 'g'
| 'b'
|...Цвет схемы поля, заданной как триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название.
Для пользовательского цвета задайте триплет 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'
BackgroundColor
Цвет фона текстового поля'none'
(значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r'
| 'g'
| 'b'
|...Цвет фона текстового поля, заданного как триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название.
Для пользовательского цвета задайте триплет 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'
LineStyle
— Стиль линии схемы поля'-'
(значение по умолчанию) | '--'
| ':'
| '-.'
| 'none'
Стиль линии схемы поля, заданной как одна из опций в этой таблице.
Стиль линии | Описание | Получившаяся строка |
---|---|---|
'-' | Сплошная линия |
|
'--' | Пунктирная линия |
|
':' | Пунктирная линия |
|
'-.' | Штрих-пунктирная линия |
|
'none' | Строка невидима |
'LineWidth'
Ширина схемы поля0.5
(значение по умолчанию) | скалярное числовое значениеШирина схемы поля, заданной как скалярное числовое значение в модулях точки. Один пункт равен 1/72 дюйма.
Пример: 1.5
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Margin
— Пробел вокруг текста в текстовом поле3
(значение по умолчанию) | скалярное числовое значениеПробел вокруг текста в текстовом поле, заданном как скалярное числовое значение в модулях точки.
MATLAB использует значение свойства Extent
плюс значение свойства Margin
, чтобы определить размер текстового поля.
Пример 8
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Clipping
— Усечение к осям строит поле'off'
(значение по умолчанию) | 'on'
Усечение текста к осям строит поле, которое является полем, заданным пределами по осям, заданными как одно из этих значений:
'off'
Не отсекайте текст. Фрагменты его могут появиться вне поля графика осей.
'on'
— Отсекает текст к полю графика осей.
Если свойство ClippingStyle
осей установлено в '3dbox'
, который является значением по умолчанию, то MATLAB или отображает целый текст или ни один из текста, в зависимости от текстового положения. Если точка, заданная текстовым свойством Position
, находится в осях, то MATLAB отображает целый текст. Если точка находится вне осей, то MATLAB не отображает ни одну из нее.
Если свойство ClippingStyle
осей установлено в 'rectangle'
, то фрагменты отображений MATLAB текста, лежащего в осях, строят поле, и не отображается, фрагменты текста, лежащего вне осей, строят поле.
Если свойство Clipping
связанных осей установлено в 'on'
, который является значением по умолчанию, то каждый отдельный объект управляет своим собственным поведением усечения. Если свойство Clipping
осей установлено в 'off'
, то MATLAB не отсекает объектов в осях, независимо от свойства Clipping
отдельного объекта.
Position
— Местоположение текста[0 0 0]
(значение по умолчанию) | двухэлементный вектор формы [x y]
| трехэлементный вектор формы [x y z]
Местоположение текста, заданного как двухэлементный вектор формы [x y]
или трехэлементный вектор формы [x y z]
. Если вы не используете третий элемент, z
, то MATLAB устанавливает его на 0
.
Задайте положение с помощью числовых значений. Чтобы преобразовать datetime или значения длительности к соответствующим числовым значениям для конкретного координатного направления, смотрите ruler2num
.
По умолчанию значение положения задано в модулях данных. Для изменения единиц используйте свойство Units.
Пример: [0.5 0.5 0]
Типы данных: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Extent
— Размер и местоположение прямоугольника, который заключает текстЭто свойство доступно только для чтения.
Размер и местоположение прямоугольника, который заключает текст, не включая поле, возвратились как четырехэлементный вектор формы [left bottom width height]
. Первые два элемента, left
и bottom
, задают положение левого нижнего угла прямоугольника. Последние два элемента, width
и height
, задают размерности прямоугольника.
По умолчанию значение степени задано в модулях данных. Для изменения единиц используйте свойство Units.
Пример: [0.5 0.5 0.4 0.2]
Модули
Положение и модули степени'data'
(значение по умолчанию) | 'normalized'
| 'inches'
| 'centimeters'
| 'characters'
| 'points'
| 'pixels'
Модули положения, заданные как одно из значений в этой таблице.
Модули | Описание |
---|---|
'data' (значение по умолчанию) | Координаты данных. |
'normalized' | Нормированный относительно осей. Левый нижний угол осей сопоставляет с (0,0) , и правый верхний угол сопоставляет с (1,1) . |
'inches' | 'inches'. |
'centimeters' | 'centimeters'. |
'characters' |
На основе размера символа системного шрифта по умолчанию.
|
'points' | 'points'. Один пункт равен 1/72 дюйма. |
'pixels' | 'pixels'. Начиная в R2015b, расстояния в пикселях независимы от вашего системного разрешения по системам Макинтоша и Windows:
В системах Linux размер пикселя определяется вашим системным разрешением. |
Все модули, за исключением 'data'
, измеряются от левого нижнего угла осей. Это свойство влияет на свойства Position
и Extent
.
Если вы задаете свойства Position
и Units
как пары Name,Value
при создании объекта Text
, то порядок вопросов спецификации. Чтобы задать положение с конкретными модулями, установите свойство Units
перед свойством Position
.
HorizontalAlignment
Выравнивание по горизонтали текста относительно точки положения'left'
(значение по умолчанию) | 'center'
| 'right'
Выравнивание по горизонтали текста относительно значения x
в свойстве Position
, заданном как одно из значений в этой таблице. Вертикальная строка указывает, где значение x
находится относительно текста.
Значение | Результат |
---|---|
'left' (значение по умолчанию) |
|
'center' |
|
'right' |
|
VerticalAlignment
Выравнивание по вертикали текста относительно точки положения'middle'
(значение по умолчанию) | 'top'
| 'bottom'
| 'baseline'
| 'cap'
Выравнивание по вертикали текста относительно значения y
в свойстве Position
, заданном как одно из значений в этой таблице. Горизонтальная строка указывает, где значение y
находится относительно текста.
Значение | Результат |
---|---|
'middle' |
|
'top' |
|
'cap' |
|
'bottom' |
|
'baseline' |
|
Editing
— Интерактивный режим редактирования'off'
(значение по умолчанию) | 'on'
Интерактивный режим редактирования, заданный как одно из этих значений:
'off'
Сделайте не позволяют интерактивное редактирование текста. Чтобы изменить текст, необходимо установить свойство String
. Это - значение по умолчанию.
'on'
— Позвольте интерактивное редактирование текста. MATLAB устанавливает курсор вставки в рамках текста и вводящих изменений текст. Чтобы применить новый текст, сделайте любое следующее:
Нажмите клавишу Esc.
Щелкните где угодно далеко от текста.
Сбросьте свойство Editing
к 'off'
.
MATLAB обновляет свойство String
содержать новый текст и сбрасывает свойство Editing
к 'off'
.
Visible
— Состояние видимости'on'
(значение по умолчанию) | 'off'
Состояние видимости, заданное в качестве одного из следующих значений:
'on' — Отображать объект.
'off' — Скрыть объект, не удаляя его.
Вы по-прежнему можете получать доступ к свойствам невидимого объекта.
UIContextMenu
Контекстное менюGraphicsPlaceholder
(значение по умолчанию) | объект ContextMenu
Контекстное меню, заданное как объект ContextMenu.
Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по объекту. Создайте контекстное меню с помощью функции uicontextmenu.
Если для свойства PickableParts задано значение 'none', или если для свойства HitTest установлено значение 'off', контекстное меню не отображается.
Selected
— Состояние выбора'off'
(значение по умолчанию) | 'on'
Состояние выбора, заданное как одно из следующих значений:
'on' — Выбран.
Если вы кликаете на объект, находясь в режиме редактирования графика, MATLAB устанавливает для свойства Selected значение 'on'.
Если для свойства SelectionHighlight задано значение 'on', MATLAB отображает маркеры выделения вокруг объекта.
off' — Не выбран.
SelectionHighlight
Отображение маркеров выделения'on'
(значение по умолчанию) | 'off'
Отображение маркеров выделения, заданное как одно из следующих значений:
'on' — Отображать маркеры выделения, если для свойства Selected задано значение 'on'.
'off' — Никогда не отображать маркеры выделения, даже если для свойства Selected задано значение 'on'.
'ButtonDownFcn'
Щелкните мышью по коллбэку''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовОбратный вызов по клику мыши, заданный как одно из следующих значений:
Указатель на функцию
Массив ячейки, содержащий указатель на функцию и дополнительные аргументы
Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)
Используйте это свойство для выполнения кода при клике по объекту. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:
Объект, по которому кликают — свойства Access объекта, по которому кликают, из функции обратного вызова.
Данные о событиях — Пустой аргумент. Замените его на символ тильды (~
) в функциональном определении, чтобы указать, что этот аргумент не используется.
Если для свойства PickableParts задано значение 'none', или если для свойства HitTest задано значение 'off', этот обратный вызов не выполняется.
CreateFcn
Функция создания''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция создания объекта, заданная как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Для получения дополнительной информации об определении коллбэка как указатель на функцию, массив ячеек или вектор символов, видит Определение Коллбэка.
Это свойство задает функцию обратного вызова, чтобы выполниться, когда MATLAB создает объект. MATLAB инициализирует все значения свойств перед выполнением обратного вызова CreateFcn.
Если вы не задаете свойство CreateFcn, то MATLAB выполняет функцию создания по умолчанию.
Настройка свойства CreateFcn в существующем компоненте не имеет никакого эффекта.
Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который создается с помощью первого аргумента функции обратного вызова. В противном случае используйте функцию gcbo
, чтобы получить доступ к объекту.
DeleteFcn
Функция удаления''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция удаления объекта, заданная как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Для получения дополнительной информации об определении коллбэка как указатель на функцию, массив ячеек или вектор символов, видит Определение Коллбэка.
Это свойство задает функцию обратного вызова, чтобы выполниться, когда MATLAB удаляет объект. MATLAB выполняет обратный вызов DeleteFcn перед уничтожением свойств объекта.
Если вы не задаете свойство DeleteFcn, то MATLAB выполняет функцию удаления по умолчанию.
Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который удаляется с помощью первого аргумента функции обратного вызова. В противном случае используйте функцию gcbo
, чтобы получить доступ к объекту.
Interruptible
— Прерывание коллбэка'on'
(значение по умолчанию) | 'off'
Прерывание обратного вызова, обозначаемое как 'on' или 'off'.
Свойство «Прерывание» определяет, можно ли прерывать выполняемый обратный вызов.
Существует два состояния обратного вызова:
Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.
Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.
Каждый раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать текущий обратный вызов (если он существует). Свойство «Прерывание» объекта, имеющего текущий обратный вызов, определяет, разрешено ли прерывание.
Свойство «Прерывание» имеет два возможных значения:
'on'
— Позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит на следующем этапе, где MATLAB обрабатывает очередь, такой как тогда, когда существует drawnow
, figure
, uifigure
, getframe
, waitfor
или команда pause
.
Если рабочий коллбэк содержит одну из тех команд, то MATLAB останавливает выполнение коллбэка в той точке и выполняет прерывание обратного вызова. MATLAB возобновляет выполнение обратного вызова при завершении прерывания.
Если рабочий коллбэк не содержит одну из тех команд, то MATLAB закончил выполнять коллбэк без прерывания.
'off'
Блоки все попытки прерывания. Свойство BusyAction объекта, владеющего прерывистым обратным вызовом, определяет, отменяется ли прерывание обратного вызова или помещается в очередь.
Прерывание и выполнение обратного вызова происходят по-разному в таких ситуациях:
Если прерывающий обратный вызов является обратным вызовом DeleteFcn, CloseRequestFcn или SizeChangedFcn, то прерывание происходит независимо от значения свойства прерывания.
Если текущий обратный вызов выполняет функцию waitfor, то прерывание происходит независимо от значения свойства прерывания.
Объекты-таймеры выполняются в соответствии с расписанием независимо от значения свойства прерывания.
Когда происходит прерывание, MATLAB не сохраняет состояние свойств или изображения. Например, объект, возвращенный командой gca или gcf, может измениться при выполнении другого обратного вызова.
BusyAction
Постановка в очередь коллбэка'queue'
(значение по умолчанию) | 'cancel'
Постановка обратного вызова в очередь задается как 'queue' или 'cancel'.
Свойство BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов.
Существует два состояния обратного вызова:
Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.
Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.
Каждый раз, когда MATLAB инициирует обратный вызов, этот обратный вызов пытается прервать текущий обратный вызов. Свойство Interruptible
объекта, владеющего рабочим коллбэком, определяет, разрешено ли прерывание. Если прерывание не разрешено, то свойство BusyAction
объекта, владеющего прерыванием обратного вызова, определяет, отбрасывается ли это или вставило очередь. Это возможные значения свойства BusyAction
:
'queue'
— Помещает прерывание обратного вызова в очередь, чтобы быть обработанным после рабочего выполнения концов коллбэка.
отмена
Не выполняет прерывание обратного вызова.
PickableParts
Способность захватить клики мыши'visible'
(значение по умолчанию) | 'all'
| 'none'
Возможность осуществить захват кликов мыши, заданная как одно из следующих значений:
'visible'
— Захватите клики мыши только, когда видимый. Свойство Visible
должно быть установлено в 'on'
. Свойство HitTest
определяет, отвечает ли объект Text
на нажатие кнопки или если предок делает.
все
Захватите клики мыши независимо от видимости. Свойство Visible
может быть установлено в 'on'
или 'off'
. Свойство HitTest
определяет, отвечает ли объект Text
на нажатие кнопки или если предок делает.
'none' — Невозможно захватить клики мыши.
Нажатие на объект Text
передает нажатие кнопки объекту ниже его в текущем представлении окна рисунка, которое обычно является осями или фигурой. Свойство HitTest
не имеет никакого эффекта.
Если вы хотите объект быть активируемыми кликом мыши, когда это под другими объектами, что вы не хотите быть активируемыми кликом мыши, то установленный свойство PickableParts
других объектов к 'none'
так, чтобы нажатие кнопки прошло через них.
HitTest
Ответ на захватил клики мыши'on'
(значение по умолчанию) | 'off'
Ответ на захваченные клики мыши, заданный как одно из следующих значений:
'on'
— Инициируйте коллбэк ButtonDownFcn
объекта Text
. Если вы определили свойство UIContextMenu, активируйте контекстное меню.
'off'
Инициируйте коллбэки для самого близкого предка объекта Text
, который имеет один из них:
Набор свойств HitTest
к 'on'
Набор свойств PickableParts
к значению, которое позволяет предку захватить клики мыши
Свойство PickableParts
определяет, может ли объект Text
захватить клики мыши. Если это невозможно, свойство HitTest никоим образом на это не влияет.
BeingDeleted
— Deletion'off'
| 'on'
Это свойство доступно только для чтения.
Удаление статуса, возврат на 'off' или 'on'.
MATLAB задает значение свойства BeingDeleted 'on', когда обратный вызов DeleteFcn начинает выполнение.
Значение свойства BeingDeleted остается 'on' до того момента, как объект перестанет существовать.
Проверьте значение свойства BeingDeleted, чтобы убедиться, что объект не будет удален до запроса или изменения.
Parent
— Родительский элементAxes
| объект PolarAxes
| объект Group
| объект Transform
Родительский элемент, заданный как Axes
, PolarAxes
, Group
или объект Transform
.
Children
— Дочерние элементыGraphicsPlaceholder
У объекта нет дочерних элементов. Вы не можете задать это свойство.
HandleVisibility
Видимость указателя на объект'on'
(значение по умолчанию) | 'off'
| 'callback'
Видимость указателя на объект в свойстве Children родителя, заданная как одно из следующих значений:
on' — указатель на объект всегда отображается.
off' — указатель на объект всегда невидим.
Эта опция предназначена для предотвращения непреднамеренных изменений в пользовательском интерфейсе другой функцией. Установите значение 'off' в HandleVisibility, чтобы временно скрыть указатель в течение выполнения этой функции.
callback' — указатель на объект виден из обратных вызовов или функций, вызываемых обратными вызовами, но не из функций, инициируемых из командной строки.
Эта опция блокирует доступ к объекту в командной строке, но разрешает функциям обратного вызова получать доступ к нему.
Если объект не указан в свойстве Children родителя, то функции, которые получают указатели на объекты путем поиска иерархии объектов или запросов свойств указателя, не могут вернуть его.
Примеры таких функций включают get
, findobj
, gca
, gcf
, gco
, newplot
, cla
, clf
и функции close
.
Скрытые указатели на объекты все еще действительны. Установите значение корневого свойства ShowHiddenHandles на 'on', чтобы отобразить все указатели на объекты независимо от значения свойства HandleVisibility.
Ввод
Тип графического объекта'text'
Это свойство доступно только для чтения.
Тип графического объекта, возвращенного как 'text'
. Используйте это свойство найти все объекты данного типа в иерархии графического вывода, например, ища тип с помощью findobj
.
Тег
Идентификатор объекта''
(значение по умолчанию) | вектор символов | представляет скаляр в виде строкиИдентификатор объекта, заданный как вектор символов или скаляр строки. Можно задать уникальное значение Tag
, чтобы служить идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать функцию findobj для поиска объекта на основе значения тега.
UserData
UserData []
(значение по умолчанию) | массивПользовательские данные, заданные как любой массив MATLAB. Например, можно задать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Используйте это свойство хранить произвольные данные на объекте.
Если вы работаете в App Designer, создаете публичные или частные свойства в приложении, чтобы осуществлять обмен данными вместо того, чтобы использовать свойство UserData
. Для получения дополнительной информации смотрите, Осуществляют обмен данными В рамках Приложений App Designer.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.