UIAxes Properties

Внешний вид и поведение осей пользовательского интерфейса

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

ax = uiaxes;
ax.Color = 'blue';

Свойства, перечисленные здесь, допустимы для осей в App Designer или в цифрах созданный с uifigure функция. Для осей, используемых в GUIDE, или в приложениях, созданных с figure функционируйте, смотрите Свойства осей графика.

Шрифт

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

Название шрифта в виде системы поддержало название шрифта. Шрифт по умолчанию зависит от конкретной операционной системы и локали.

Если заданный шрифт не доступен, то MATLAB® использует лучшее соответствие среди шрифтов, доступных в системе, куда приложение запускается.

Пример: 'Arial'

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

MATLAB автоматически масштабирует часть текста к проценту размера шрифта осей.

  • Заголовки и подписи по осям — 110% размера шрифта осей по умолчанию. Чтобы управлять масштабированием, используйте TitleFontSizeMultiplier и LabelFontSizeMultiplier свойства.

  • Легенды и шкалы палитры — 90% размера шрифта осей по умолчанию. Чтобы задать различный размер шрифта, установите FontSize свойство для Legend или Colorbar объект вместо этого.

Пример: ax.FontSize = 12

Режим выбора для размера шрифта в виде одного из этих значений:

  • 'auto' — Размер шрифта задан MATLAB. Если вы изменяете размер осей, чтобы быть меньшими, чем размер по умолчанию, размер шрифта может уменьшиться, чтобы улучшить удобочитаемость и размещение.

  • 'manual' — Размер шрифта задан вручную. Не масштабируйте размер шрифта, когда размер осей изменяется. Чтобы задать размер шрифта, установите FontSize свойство.

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

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

Символьный наклон в виде 'normal' или 'italic'.

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

Масштабный коэффициент для размера шрифта метки в виде числового значения, больше, чем 0. Масштабный коэффициент применяется к значению FontSize свойство определить размер шрифта для оси X, оси Y и меток оси z.

Пример: ax.LabelFontSizeMultiplier = 1.5

Масштабный коэффициент для размера шрифта заголовка в виде числового значения, больше, чем 0. Масштабный коэффициент применяется к значению FontSize свойство определить размер шрифта для заголовка.

Пример: ax.TitleFontSizeMultiplier = 1.75

Толщина заглавного героя в виде одного из этих значений:

  • 'normal' — Вес по умолчанию, как задано конкретным шрифтом

  • 'bold' — Более толстые символы, чем нормальный

Толщина символа подзаголовка в виде одного из этих значений:

  • 'normal' — Вес по умолчанию, как задано конкретным шрифтом

  • 'bold' — Более толстые символы, чем нормальный

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

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

'pixels'.

Начиная с версии R2015b, значения размеров в пикселях не зависят от вашего системного разрешения в системах Windows® и Macintosh.

  • В системах Windows пиксель составляет 1/72 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • В системах Linux® размер пикселя определяется вашим системным разрешением.

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

Символьное сглаживание, возвращенное как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Примечание

Сглаживание шрифта всегда включено независимо от значения этого свойства. Изменение значения не оказывает влияния.

Метки деления

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

Значения деления в виде вектора из увеличения значений. Если вы не хотите отметок деления вдоль оси, то задайте пустой вектор []. Значения деления являются местоположениями вдоль оси, где отметки деления появляются. Метки в виде галочки являются метками, которые вы видите рядом с каждой отметкой деления. Используйте XTickLabelsyticklabels, и ZTickLabels свойства задать связанные метки.

Пример: ax.XTick = [2 4 6 8 10]

Пример: ax.YTick = 0:10:100

В качестве альтернативы используйте xticks, yticks, и zticks функции, чтобы задать значения деления. Для примера смотрите, Задают Значения Метки деления на оси и Метки.

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

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

  • 'auto' — Автоматически выберите значения деления на основе области значений данных для оси.

  • 'manual' — Вручную задайте значения деления. Чтобы задать значения, установите XTick, YTick, или ZTick свойство.

Пример: ax.XTickMode = 'auto'

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

Метки в виде галочки поддерживают TeX и ПРОПИТЫВАЮТ ЛАТЕКСОМ разметку. Смотрите TickLabelInterpreter свойство для получения дополнительной информации.

Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, не категории.

Как альтернатива установке этого свойства, можно использовать xticklabels, yticklabels, и zticklabels функции. Для примера смотрите, Задают Значения Метки деления на оси и Метки.

Пример: ax.XTickLabel = {'Jan','Feb','Mar','Apr'}

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

  • 'auto' — Автоматически выберите метки в виде галочки.

  • 'manual' — Вручную задайте метки в виде галочки. Чтобы задать метки, установите XTickLabel, YTickLabel, или ZTickLabel свойство.

Пример: ax.XTickLabelMode = 'auto'

Интерпретатор метки в виде галочки в виде одного из этих значений:

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

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

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

TeX Markup

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

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете интерпретатор на '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Пурпурный, blue, black, whiteсерый, darkGreen, orange, или lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Цвет пользовательского шрифта — Замена specifier с трехэлементным триплетом RGB.'\color[rgb]{0,0.5,0.5} text'

Эта таблица приводит поддерживаемые специальные символы для '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, установите TickLabelInterpreter свойство к '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/.

Вращение метки в виде галочки в виде числового значения в градусах. Положительные значения дают против часовой стрелки вращение. Отрицательные величины дают по часовой стрелке вращение.

Пример: ax.XTickLabelRotation = 45

Пример: ax.YTickLabelRotation = 90

В качестве альтернативы используйте xtickangle, ytickangle, и ztickangle функции.

Незначительные отметки деления в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Отобразите незначительные отметки деления между главными отметками деления на оси. Пробел между главными отметками деления определяет количество незначительных отметок деления. Это значение является значением по умолчанию для оси с логарифмической шкалой.

  • 'off' — Не отображайте незначительные отметки деления. Это значение является значением по умолчанию для оси с линейной шкалой.

Пример: ax.XMinorTick = 'on'

Направление отметки деления в виде одного из этих значений:

  • 'in' — Направьте отметки деления внутрь от линий оси. (Значение по умолчанию для 2D представлений)

  • 'out' — Направьте отметки деления, исходящие от линий оси. (Значение по умолчанию для 3-D представлений)

  • 'both' — Сосредоточьте отметки деления по линиям оси.

Пример: ax.TickDir = 'out'

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

  • 'auto' — Автоматически выберите направление метки деления на основе текущего представления.

  • 'manual' — Вручную задайте направление метки деления. Чтобы задать направление метки деления, установите TickDir свойство.

Пример: ax.TickDirMode = 'auto'

Длина отметки деления в виде двухэлементного вектора из формы [2Dlength 3Dlength]. Первым элементом является длина отметки деления в 2D представлениях, и вторым элементом является длина отметки деления в 3-D представлениях. Задайте значения в модулях, нормированных относительно самой длинной из видимой оси X, оси Y или линий оси z.

Пример: ax.TickLength = [0.02 0.035]

Линейки

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

Минимум и максимум ограничивают в виде двухэлементного вектора из формы [min max], где max больше min. Можно задать пределы как числовые, категориальные, datetime или значения длительности. Однако тип значений, которые вы задаете, должен совпадать с типом значений вдоль оси.

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

Пример: ax.XLim = [0 10]

Пример: ax.YLim = [-inf 10]

Пример: ax.ZLim = [0 inf]

В качестве альтернативы используйте xlim, ylim, и zlim функции, чтобы установить пределы. Для примера смотрите Задание пределов по осям.

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

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

  • 'auto' — Автоматически выберите пределы по осям на основе отображенных на графике данных, который является, общий промежуток XData, YData, или ZData из всех объектов, отображенных в осях.

  • 'manual' — Вручную задайте пределы по осям. Чтобы задать пределы по осям, установите XLimylim, или ZLim свойство.

Пример: ax.XLimMode = 'auto'

Линейка оси, возвращенная как объект линейки. Линейка управляет внешним видом и поведением оси X, оси Y или оси z. Измените внешний вид и поведение конкретной оси путем доступа к связанной линейке и установки свойств линейки. Тип линейки, которую MATLAB создает для каждой оси, зависит от отображенных на графике данных. Для списка свойств линейки см.:

Например, получите доступ к линейке для оси X через XAxis свойство. Затем измените Color свойство линейки, и таким образом цвет оси X, к красному. Точно так же измените цвет оси Y к зеленому.

ax = gca;
ax.XAxis.Color = 'r';
ax.YAxis.Color = 'g';
Если Axes объект имеет два y - оси, затем YAxis свойство хранит два объекта линейки.

x- местоположение оси в виде одного из значений в этой таблице. Это свойство применяется только к 2D представлениям.

ЗначениеОписаниеРезультат
'bottom'

Нижняя часть осей.

Пример: ax.XAxisLocation = 'bottom'

'top'

Верхняя часть осей.

Пример: ax.XAxisLocation = 'top'

'origin'

Через точку (0,0) источника.

Пример: ax.XAxisLocation = 'origin'

y- местоположение оси в виде одного из значений в этой таблице. Это свойство применяется только к 2D представлениям.

ЗначениеОписаниеРезультат
'left'

Левая сторона осей.

Пример: ax.YAxisLocation = 'left'

'right'

Правая сторона осей.

Пример: ax.YAxisLocation = 'right'

'origin'

Через точку (0,0) источника.

Пример: ax.YAxisLocation = 'origin'

Цвет линии оси, значений деления, и меток в x, y, или z направления в виде триплета RGB, шестнадцатеричного цветового кода, названия цвета или краткого названия. Цвет также влияет на линии сетки, если вы не задаете цвет линий сетки с помощью GridColor или MinorGridColor свойство.

Для пользовательского цвета задайте триплет 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'

Пример: ax.XColor = [1 1 0]

Пример: ax.YColor = 'yellow'

Пример: ax.ZColor = '#FFFF00'

Свойство для установки x - цвет сетки оси в виде 'auto' или 'manual'. Значение режима только влияет на x - цвет сетки оси. x - линия оси, значения деления и метки всегда используют XColor значение, независимо от режима.

x - цвет сетки оси зависит от обоих XColorMode свойство и GridColorMode свойство, как показано здесь.

XColorModeGridColorMode цвет сетки оси X
'auto''auto'GridColor свойство
'manual'GridColor свойство
'manual''auto'XColor свойство
'manual'GridColor свойство

x - ось незначительный цвет сетки зависит от обоих XColorMode свойство и MinorGridColorMode свойство, как показано здесь.

XColorModeMinorGridColorMode ось X Незначительный цвет сетки
'auto''auto'MinorGridColor свойство
'manual'MinorGridColor свойство
'manual''auto'XColor свойство
'manual'MinorGridColor свойство

Свойство для установки y - цвет сетки оси в виде 'auto' или 'manual'. Значение режима только влияет на y - цвет сетки оси. y - линия оси, значения деления и метки всегда используют YColor значение, независимо от режима.

y - цвет сетки оси зависит от обоих YColorMode свойство и GridColorMode свойство, как показано здесь.

YColorModeGridColorMode цвет сетки оси Y
'auto''auto'GridColor свойство
'manual'GridColor свойство
'manual''auto'YColor свойство
'manual'GridColor свойство

y - ось незначительный цвет сетки зависит от обоих YColorMode свойство и MinorGridColorMode свойство, как показано здесь.

YColorModeMinorGridColorMode ось Y Незначительный цвет сетки
'auto''auto'MinorGridColor свойство
'manual'MinorGridColor свойство
'manual''auto'YColor свойство
'manual'MinorGridColor свойство

Свойство для установки z - цвет сетки оси в виде 'auto' или 'manual'. Значение режима только влияет на z - цвет сетки оси. z - линия оси, значения деления и метки всегда используют ZColor значение, независимо от режима.

z - цвет сетки оси зависит от обоих ZColorMode свойство и GridColorMode свойство, как показано здесь.

ZColorModeGridColorMode цвет сетки оси z
'auto''auto'GridColor свойство
'manual'GridColor свойство
'manual''auto'ZColor свойство
'manual'GridColor свойство

z - ось незначительный цвет сетки зависит от обоих ZColorMode свойство и MinorGridColorMode свойство, как показано здесь.

ZColorModeMinorGridColorMode ось z Незначительный цвет сетки
'auto''auto'MinorGridColor свойство
'manual'MinorGridColor свойство
'manual''auto'ZColor свойство
'manual'MinorGridColor свойство

x- направление оси в виде одного из этих значений.

ЗначениеОписаниеПриведите к 2DПриведите к 3-D
'normal'

Значения увеличиваются слева направо.

Пример: ax.XDir = 'normal'

'reverse'

Значения увеличиваются справа налево.

Пример: ax.XDir = 'reverse'

y- направление оси в виде одного из этих значений.

ЗначениеОписаниеПриведите к 2DПриведите к 3-D
'normal'

Значения увеличиваются от нижней части до верхней части (2D представление) или по всей длине (3-D представление).

Пример: ax.YDir = 'normal'

'reverse'

Значения увеличиваются сверху донизу (2D представление) или наоборот (3-D представление).

Пример: ax.YDir = 'reverse'

z- направление оси в виде одного из этих значений.

ЗначениеОписаниеПриведите к 3-D
'normal'

Увеличение значений, указывающее из экрана (2D представление) или от нижней части до верхней части (3-D представление).

Пример: ax.ZDir = 'normal'

'reverse'

Увеличение значений, указывающее в экран (2D представление) или сверху донизу (3-D представление).

Пример: ax.ZDir = 'reverse'

Шкала оси в виде одного из этих значений.

ЗначениеОписаниеРезультат
'linear'

Линейная шкала

Пример: ax.XScale = 'linear'

'log'

Логарифмическая шкала

Пример: ax.XScale = 'log'

Сетки

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

Линии сетки в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Отобразите перпендикуляр линий сетки к оси; например, вдоль линий постоянного x, y, или z значений.

  • 'off' — Не отображайте линии сетки.

В качестве альтернативы используйте grid on или grid off команда, чтобы установить все три свойства на 'on' или 'off', соответственно. Для получения дополнительной информации смотрите grid.

Пример: ax.XGrid = 'on'

Размещение линий сетки и отметок деления относительно графических объектов в виде одного из этих значений:

  • 'bottom' — Отобразите отметки деления и линии сетки под графическими объектами.

  • 'top' — Отобразите отметки деления и линии сетки по графическим объектам.

Это свойство влияет только на 2D представления.

Пример: ax.Layer = 'top'

Стиль линии для линий сетки в виде одного из стилей линии в этой таблице.

Стиль линииОписаниеПолучившаяся линия
'-'Сплошная линия

'--'Пунктирная линия

':'Пунктирная линия

'-.'Штрих-пунктирная линия

'none'Никакая линияНикакая линия

Чтобы отобразить линии сетки, используйте grid on команда или набор XGrid, YGrid, или ZGrid свойство к 'on'.

Пример: ax.GridLineStyle = '--'

Цвет линий сетки в виде триплета 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'

Чтобы выбрать цвета для схемы поля осей, используйте XColor, YColor, и ZColor свойства.

Чтобы отобразить линии сетки, используйте grid on команда или набор XGrid, YGrid, или ZGrid свойство к 'on'.

Пример: ax.GridColor = [0 0 1]

Пример: ax.GridColor = 'blue'

Пример: ax.GridColor = '#0000FF'

Свойство для установки цвета сетки в виде одного из этих значений:

  • 'auto' — Проверяйте значения XColorMode, YColorMode, и ZColorMode свойства определить цвета линий сетки для x, y и направлений z.

  • 'manual' — Используйте GridColor установить цвет линий сетки для всех направлений.

Прозрачность линии сетки в виде значения в области значений [0,1]. Значение 1 означает непрозрачный и значение 0 абсолютно прозрачные средние значения.

Пример: ax.GridAlpha = 0.5

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

  • 'auto' — Значение прозрачности по умолчанию 0.15.

  • 'manual' — Вручную задайте значение прозрачности. Чтобы задать значение, установите GridAlpha свойство.

Пример: ax.GridAlphaMode = 'auto'

Незначительные линии сетки в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Отобразите линии сетки, выровненные с незначительными отметками деления оси. Вы не должны позволять незначительным меткам деления отобразить незначительные линии сетки.

  • 'off' — Не отображайте линии сетки.

В качестве альтернативы используйте grid minor команда, чтобы переключить видимость незначительных линий сетки.

Пример: ax.XMinorGrid = 'on'

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

Стиль линииОписаниеПолучившаяся линия
'-'Сплошная линия

'--'Пунктирная линия

':'Пунктирная линия

'-.'Штрих-пунктирная линия

'none'Никакая линияНикакая линия

Чтобы отобразить незначительные линии сетки, используйте grid minor команда или набор XMinorGrid, YMinorGrid, или ZMinorGrid свойство к 'on'.

Пример: ax.MinorGridLineStyle = '-.'

Цвет незначительных линий сетки в виде триплета 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'

Чтобы отобразить незначительные линии сетки, используйте grid minor команда или набор XMinorGrid, YMinorGrid, или ZMinorGrid свойство к 'on'.

Пример: ax.MinorGridColor = [0 0 1]

Пример: ax.MinorGridColor = 'blue'

Пример: ax.MinorGridColor = '#0000FF'

Свойство для установки незначительного цвета сетки в виде одного из этих значений:

  • 'auto' — Проверяйте значения XColorMode, YColorMode, и ZColorMode свойства определить цвета линий сетки для x, y и направлений z.

  • 'manual' — Используйте MinorGridColor установить незначительный цвет линий сетки для всех направлений.

Незначительная прозрачность линии сетки в виде значения в области значений [0,1]. Значение 1 означает непрозрачный и значение 0 абсолютно прозрачные средние значения.

Пример: ax.MinorGridAlpha = 0.5

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

  • 'auto' — Значение прозрачности по умолчанию 0.25.

  • 'manual' — Вручную задайте значение прозрачности. Чтобы задать значение, установите MinorGridAlpha свойство.

Пример: ax.MinorGridAlphaMode = 'auto'

Метки

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

Текстовый объект для заголовка осей. Чтобы добавить заголовок, установите String свойство текстового объекта. Чтобы изменить внешний вид заголовка, такой как стиль шрифта или цвет, устанавливают другие свойства. Для полного списка смотрите Text Properties.

ax = uiaxes;
ax.Title.String = 'My Graph Title';
ax.Title.FontWeight = 'normal';

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

title(ax,'My Title','FontWeight','normal')

Текстовый объект для подзаголовка осей. Чтобы добавить подзаголовок, установите String свойство текстового объекта. Чтобы изменить его внешний вид, такой как угол шрифта, устанавливают другие свойства. Для полного списка смотрите Text Properties.

ax = uiaxes;
ax.Subtitle.String = 'An Insightful Subtitle';
ax.Subtitle.FontAngle = 'italic';

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

% subtitle function
subtitle(ax,'Insightful Subtitle','FontAngle','italic')

% title function
[t,s] = title(ax,'Clever Title','Insightful Subtitle');
s.FontAngle = 'italic';

Примечание

Этот текстовый объект не содержится в Children свойство UIAxes объект. Это не может быть возвращено findobj, это и не использует значения по умолчанию, заданные для текстовых объектов.

Заголовок и выравнивание по горизонтали подзаголовка с полем графика в виде одного из значений из таблицы.

TitleHorizontalAlignment ЗначениеОписаниеВнешний вид
'center'Заголовок и подзаголовок сосредоточены по полю графика.

Title and subtitle centered over the plot box.

'left'Заголовок и подзаголовок выравниваются с левой стороной поля графика.

Title and subtitle aligned with left edge of the plot box.

'right'Заголовок и подзаголовок выравниваются с правой стороной поля графика.

Title and subtitle aligned with right edge of the plot box.

Текстовый объект для подписи по осям. Чтобы добавить подпись по осям, установите String свойство текстового объекта. Чтобы изменить внешний вид метки, такой как размер шрифта, устанавливают другие свойства. Для полного списка смотрите Text Properties.

ax = uiaxes;
ax.YLabel.String = 'y-Axis Label';
ax.YLabel.FontSize = 12;

В качестве альтернативы используйте xlabel, ylabel, и zlabel функции, чтобы добавить подпись по осям и управлять внешним видом.

ylabel(ax,'My y-Axis Label','FontSize',12)

Это свойство доступно только для чтения.

Легенда сопоставлена с UIAxes объект в виде Legend объект. Чтобы добавить легенду в оси, используйте legend функция. Затем можно использовать это свойство изменить легенду. Для полного списка свойств смотрите Legend Properties.

ax = uiaxes;
ax.Legend.TextColor = 'red';

Также можно использовать это свойство определить, имеют ли оси легенду.

ax = uiaxes;
lgd = ax.Legend
if ~isempty(lgd)
    disp('Legend Exists')
end

Несколько графиков

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

Последовательность цветов в виде матрицы с тремя столбцами триплетов RGB. Это свойство задает палитру цветов использование MATLAB, чтобы создать объекты графика, такие как Lineрассеяние, и Bar объекты. Каждой строкой массива является триплет RGB. Триплет RGB является трехэлементным вектором, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0, 1]. Эта таблица приводит цвета по умолчанию.

ЦветаColorOrder Матрица


    [    0    0.4470    0.7410
    0.8500    0.3250    0.0980
    0.9290    0.6940    0.1250
    0.4940    0.1840    0.5560
    0.4660    0.6740    0.1880
    0.3010    0.7450    0.9330
    0.6350    0.0780    0.1840]

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

Изменение последовательности цветов прежде или после графического вывода

Начиная в R2019b, можно изменить последовательность цветов любым из следующих способов:

  • Вызовите colororder функционируйте, чтобы изменить последовательность цветов для всех осей на рисунке. Цвета существующих графиков в фигуре сразу обновляются. Если вы помещаете дополнительные оси в фигуру, те оси также используют новую последовательность цветов. Если вы продолжаете вызывать команды графического вывода, те команды также используют новые цвета.

  • Установите ColorOrder свойство на осях, вызовите hold функционируйте, чтобы установить состояние удержания осей на 'on', и затем вызовите желаемые функции построения графика. Это похоже на вызов colororder функция, но в этом случае вы устанавливаете порядок цветов для определенных осей, не целую фигуру. Установка hold утвердите к 'on' необходимо, чтобы гарантировать, что последующие команды графического вывода не сбрасывают оси, чтобы использовать порядок цвета по умолчанию.

Если вы используете R2019a, или более ранний релиз, изменяя матрицу последовательности цветов не влияет на существующие графики. Измениться раскрашивает существующий график, необходимо установить ColorOrder свойство, и затем набор состояние удержания осей к 'on' прежде, чем вызвать любые функции построения графика.

Поведение этого свойства изменяется в R2019b. Для получения дополнительной информации см.:

Индекс последовательности цветов в виде положительного целого числа. Это свойство указывает, что следующий цветной MATLAB выбирает из осей ColorOrder свойство, когда это создает следующий объект графика, такой как Lineрассеяние, или Bar объект. Например, если значением индекса последовательности цветов является 1, затем следующий объект, добавленный к использованию осей первое, раскрашивает ColorOrder матрица. Если значение индекса превышает количество, раскрашивает ColorOrder матрица, затем значение индекса по модулю количества раскрашивает ColorOrder матрица определяет цвет следующего объекта.

Когда NextPlot свойство осей установлено в 'add', затем повышения стоимости индекса последовательности цветов каждый раз вы добавляете новый график в оси. Чтобы запуститься снова с первого цвета, установите ColorOrderIndex свойство к 1.

Поведение этого свойства изменяется в R2019b. Для получения дополнительной информации см. схему Indexing ColorOrder, и LineStyleOrder может изменить цвета графика и стили линии.

Порядок стиля линии в виде вектора символов, массива ячеек из символьных векторов или массива строк. Это списки свойств стили линии, что использование MATLAB, чтобы отобразить несколько сюжетных линий в осях. MATLAB присваивает стили линиям согласно их порядку создания. Это превращается в стиль следующей строки только после циклического повторения через все цвета в ColorOrder свойство с текущим стилем линии. LineStyleOrder по умолчанию имеет только один стиль линии, '-'.

Чтобы настроить порядок стиля линии, создайте массив ячеек из символьных векторов или массив строк. Укажите каждый элемент массива как спецификатор линии или спецификатор маркера из следующих таблиц. Можно объединить линию и спецификатор маркера в один элемент, такой как '-*'.

Спецификатор линииОписание
'-' (значение по умолчанию) Сплошная линия
'--'Пунктирная линия
':'Пунктирная линия
'-.'Штрих-пунктирная линия

Спецификатор маркераОписание
'+'Маркеры знака "плюс"
'o'Круговые маркеры
'*'Маркеры-звездочки
'.'Укажите маркеры
'x'Перекрестные маркеры
's'Квадратные маркеры
'd'Ромбовидные маркеры
'^'Маркеры Треугольника, направленного вверх
'v'Маркеры Нисходящего треугольника
'>'Маркеры треугольника, указывающего вправо
'<'Маркеры треугольника, указывающего влево
'p'Пятиконечная звезда (пентаграмма) маркеры
'h'Маркеры Шестиконечной звезды (гексаграмма)

Изменение порядка стиля линии прежде или после графического вывода

Начиная в R2019b, можно изменить порядок стиля линии прежде или после графического вывода в оси. Когда вы устанавливаете LineStyleOrder свойство к новому значению, MATLAB обновляет стили любых линий, которые находятся в осях. Если вы продолжаете строить в оси, ваши команды графического вывода продолжают использовать стили линии из обновленного списка.

Если вы используете R2019a или более ранний релиз, необходимо изменить порядок стиля линии перед графическим выводом. Установите значение LineStyleOrder свойство, и затем вызывает hold функционируйте, чтобы установить состояние удержания осей на 'on' прежде, чем вызвать любые функции построения графика.

Поведение этого свойства изменяется в R2019b. Для получения дополнительной информации см.:

Порядок стиля линии индексирует в виде положительного целого числа. Это свойство задает стиль следующей строки, MATLAB выбирает из осей LineStyleOrder свойство создать следующую сюжетную линию. Например, если это свойство установлено в 1, затем следующая сюжетная линия, которую вы добавляете в оси, использует первый элемент в LineStyleOrder свойство. Если значение индекса превышает количество стилей линии в LineStyleOrder массив, затем значение индекса по модулю числа элементов в LineStyleOrder массив определяет стиль следующей строки.

Когда NextPlot свойство осей установлено в 'add', MATLAB постепенно увеличивает значение индекса после циклического повторения через все цвета в ColorOrder свойство с текущим стилем линии. Чтобы запуститься снова с первого стиля линии, установите LineStyleOrderIndex свойство к 1.

Поведение этого свойства изменяется в R2019b. Для получения дополнительной информации см. схему Indexing ColorOrder, и LineStyleOrder может изменить цвета графика и стили линии.

Это свойство доступно только для чтения.

SeriesIndex значение для следующего объекта графика, добавленного к осям, возвращенным в целом номер, больше, чем или равный 0. Это свойство полезно, когда это необходимо, чтобы отследить как цикл объектов через цвета и стили линии. Это свойство обеспечивает количество объектов в осях, которые имеют SeriesIndex свойство. MATLAB использует его, чтобы присвоить SeriesIndex значение к каждому новому объекту. Количество запускается в 1 когда вы создаете оси, и это увеличивается 1 для каждого дополнительного объекта. Таким образом количеством обычно является n +1, где n является количеством объектов в осях.

Если вы вручную изменяете ColorOrderIndex или LineStyleOrderIndex свойство на осях, значении NextSeriesIndex свойство превращается в 0. Как следствие, объекты, которые имеют SeriesIndex свойство больше не обновляется автоматически, когда вы изменяете ColorOrder или LineStyleOrder свойства на осях.

Свойства сбросить при добавлении нового графика в оси в виде одного из этих значений:

  • 'add' — Добавьте новые графики в существующие оси. Не удаляйте существующие графики или сбрасывайте свойства осей прежде, чем отобразить новый график.

  • 'replacechildren' — Удалите существующие графики прежде, чем отобразить новый график. Сбросьте ColorOrderIndex и LineStyleOrderIndex свойства к 1, но не сбрасывайте другие свойства осей. Следующий график, добавленный к осям, использует первый цветной и стиль линии на основе ColorOrder и LineStyle закажите свойства. Это значение похоже на использование cla перед каждым новым графиком.

  • 'replace' — Удалите существующие графики и сбросьте свойства осей, кроме Position и Units, к их значениям по умолчанию прежде, чем отобразить новый график.

  • 'replaceall' — Удалите существующие графики и сбросьте свойства осей, кроме Position и Units, к их значениям по умолчанию прежде, чем отобразить новый график. Это значение похоже на использование cla reset перед каждым новым графиком.

Примечание

Для UIAxes объекты только с одной осью Y, 'replace' и 'replaceall' значения свойств эквивалентны. Для Axes объекты с двумя осями Y, 'replace' значение влияет только на активную сторону в то время как 'replaceall' значение влияет на обе стороны.

Фигуры, созданные с uifigure функция также имеет NextPlot свойство. В качестве альтернативы можно использовать newplot функция, чтобы подготовить фигуры и оси для последующих графических команд.

Порядок для рендеринга объектов в виде одного из этих значений:

  • 'depth' — Графические объекты в наоборот заказывают на основе текущего представления. Используйте это значение, чтобы гарантировать, что объекты перед другими объектами чертятся правильно.

  • 'childorder' — Графические объекты в порядке, в котором они создаются графическими функциями, не рассматривая отношения объектов в трех измерениях. Это значение может привести к более быстрому рендерингу, особенно если фигура является очень крупной, но также и может привести к неподходящей сортировке глубины отображенных объектов.

Цвет и карты прозрачности

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

Карта цветов в виде m- 3 массив RGB (красный, зеленый, синий) триплеты, которые задают m отдельные цвета.

Пример: ax.Colormap = [1 0 1; 0 0 1; 1 1 0] устанавливает карту цветов на три цвета: пурпурный, синий цвет, и желтый.

MATLAB получает доступ к этим цветам их номером строки.

В качестве альтернативы используйте colormap функционируйте, чтобы изменить карту цветов.

Масштабируйтесь для отображения цвета в виде одного из этих значений:

  • 'linear' — Линейная шкала. Значения деления вдоль шкалы палитры также используют линейную шкалу.

  • 'log' — Логарифмическая шкала. Значения деления вдоль шкалы палитры также используют логарифмическую шкалу.

Пример: ax.ColorScale = 'log'

Цветные пределы для объектов в осях, которые используют палитру в виде двухэлементного вектора из формы [cmin cmax]. Это свойство определяет, как значения данных сопоставляют с цветами в палитре где:

  • cmin задает значение данных, которое сопоставляет с первым, раскрашивают палитру.

  • cmax задает значение данных, которое сопоставляет с последним цветом в палитре.

Axes объект интерполирует значения данных между cmin и cmax через палитру. Значения вне этой области значений используют или первый или последний цвет, какой бы ни является самым близким.

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

  • 'auto' — Автоматически выберите пределы на основе цветных данных графических объектов, содержавшихся в осях.

  • 'manual' — Вручную задайте значения. Чтобы задать значения, установите CLim свойство. Значения не изменяются, когда пределы дочерних элементов осей изменяются.

Карта прозрачности в виде массива конечных альфа-значений, которые прогрессируют линейно от 0 к 1. Размер массива может быть m-1 или 1 m. Альфа-значения доступов MATLAB их индексом в массиве. Alphamaps может быть любой длиной.

Масштабируйтесь для отображения прозрачности в виде одного из этих значений:

  • 'linear' — Линейная шкала

  • 'log' — Логарифмическая шкала

Пример: ax.AlphaScale = 'log'

Альфа ограничивает в виде двухэлементного вектора из формы [amin amax]. Это свойство влияет на AlphaData значения графических объектов, такие как поверхность, изображение и объекты закрашенной фигуры. Это свойство определяет как AlphaData значения сопоставляют с альфа-картой фигуры, где:

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

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

UIAxes объект интерполирует значения данных между amin и amax через альфа-карту фигуры. Значения вне этой области значений используют или первое или последнее альфа-значение карты, какой бы ни является самым близким.

Alphamap свойство фигуры содержит альфа-карту. Для получения дополнительной информации смотрите alpha функция.

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

  • 'auto' — Автоматически выберите пределы на основе AlphaData значения графических объектов содержатся в осях.

  • 'manual' — Вручную задайте альфа-пределы. Чтобы задать альфа-пределы, установите ALim свойство.

Моделирование поля

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

Цвет области построения в виде триплета RGB, шестнадцатеричного цветового кода, названия цвета или краткого названия. Цвет влияет на область, заданную InnerPosition значение свойства.

Для пользовательского цвета задайте триплет 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'

Пример: ax.Color = [0 0 1]

Пример: ax.Color = 'blue'

Пример: ax.Color = '#0000FF'

Цвет поля вокруг области построения, возвращенной как 'none'.

Примечание

Установка этого свойства не оказывает влияния.

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

Пример: ax.LineWidth = 1.5

Схема поля в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

ЗначениеОписание2D Результат3-D Результат
'on'

Отобразите схему поля вокруг осей. Для 3-D представлений используйте BoxStyle свойство изменить степень схемы.

Пример: ax.Box = 'on'

'off'

Не отображайте схему поля вокруг осей.

Пример: ax.Box = 'off'

XColor, YColor, и ZColor свойства управляют цветом схемы.

Пример: ax.Box = 'on'

Стиль структуры поля в виде 'back' или 'full'. Это свойство влияет только на 3-D представления.

ЗначениеОписаниеРезультат
'back'

Обрисуйте в общих чертах объединительные платы 3-D поля.

Пример: ax.BoxStyle = 'back'

'full'

Обрисуйте в общих чертах целое 3-D поле.

Пример: ax.BoxStyle = 'full'

Усечение объектов к осям ограничивает в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Поведение усечения объекта в Axes объект зависит от обоих Clipping свойство Axes возразите и Clipping свойство отдельного объекта. Значение свойства Axes объект оказывает эти влияния:

  • 'on' — Позвольте каждому отдельному объекту в осях управлять своим собственным поведением усечения на основе Clipping значение свойства для объекта.

  • 'off' — Отключите усечение для всех объектов в осях, независимо от Clipping значение свойства для отдельных объектов. Части объектов могут появиться за пределами пределов осей. Например, части могут появиться вне пределов, если вы создаете график, используйте hold on команда, заморозьте масштабирование оси, и затем добавьте график, который больше, чем исходный график.

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

Усечение свойства для объекта осейУсечение свойства для отдельного объектаРезультат
'on''on'Отдельный объект отсекается. Другие могут или не могут быть.
'on''off'Отдельный объект не отсекается. Другие могут или не могут быть.
'off''on'Все объекты не отсечены.
'off''off'Все объекты не отсечены.

Усечение контуров в виде одного из значений в этой таблице. Если график содержит маркеры, то, пока точка данных находится в пределах осей, MATLAB чертит целый маркер.

ClippingStyle свойство не оказывает влияния если Clipping свойство установлено в 'off'.

ЗначениеОписанияРисунок граничной области
'3dbox'

Отсеките построенные объекты шести сторонам поля осей, заданного пределами по осям.

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

'rectangle'

Отсеките построенные объекты к прямоугольному контуру, заключающему оси в любое высказанное мнение.

Отсеките толстые линии в пределах осей.

Цвет фонового освещения в виде триплета RGB, шестнадцатеричного цветового кода, названия цвета или краткого названия. Фоновое освещение является бесцельным светом, который сияет однородно на всех объектах в осях. Чтобы добавить свет, используйте light функция.

Для пользовательского цвета задайте триплет 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'

Пример: ax.AmbientLightColor = [1 0 1]

Пример: ax.AmbientLightColor = 'magenta'

Пример: ax.AmbientLightColor = '#FF00FF'

Положение

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

Размер и местоположение осей, включая метки и поля в виде четырехэлементного вектора из формы [left bottom width height]. Это свойство эквивалентно OuterPosition свойство. Вектор задает прямоугольник, который заключает внешние границы осей. Значения измеряются в модулях, заданных Units свойство, который значения по умолчанию к пикселям.

  • left и bottom элементы задают положение прямоугольника, измеренного от левого нижнего угла родительского контейнера.

  • width и height задайте размер прямоугольника.

Если вы хотите задать положение и составлять текст вокруг осей, то установленный любой Position или OuterPosition свойство. Эти рисунки показывают области, заданные Position (или OuterPosition) в синем и InnerPosition в красном.

2D представление осей3-D представление осей

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Внутренний размер и местоположение, исключая метки и поля в виде четырехэлементного вектора из формы [left bottom width height]. Значения измеряются в модулях, заданных Units свойство, который значения по умолчанию к пикселям.

  • left и bottom элементы задают положение прямоугольника, измеренного от левого нижнего угла родительского контейнера.

  • width и height задайте размер прямоугольника.

Если вы хотите задать положение и составлять текст вокруг осей, то установленный любой Position или OuterPosition свойство. Эти рисунки показывают области, заданные Position (или OuterPosition) в синем и InnerPosition в красном.

2D представление осей3-D представление осей

MATLAB автоматически устанавливает InnerPosition к самым большим значениям, которые соответствуют всем другим свойствам. Другой UIAxes свойства, которые влияют на размер осей и форму, включают PositionDataAspectRatio и PlotBoxAspectRatio.

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Размер и местоположение осей, включая метки и поля в виде четырехэлементного вектора из формы [left bottom width height].

Это значение свойства идентично Position значение свойства.

Это свойство доступно только для чтения.

Поле для текстовых меток в виде четырехэлементного вектора из формы [left bottom right top]. Элементы задают расстояния между границами InnerPosition свойство и степень текстовых меток осей и заголовка. По умолчанию значения измеряются в пикселях. Чтобы изменить модули, установите Units свойство.

Свойство Position содержать постоянный при добавлении, удаляя или изменяя художественные оформления в виде одного из следующих значений:

  • 'outerposition'OuterPosition свойство остается постоянным, когда вы добавляете, удаляете, или художественные оформления изменения, такие как заголовок или подпись по осям. Если какие-либо позиционные корректировки необходимы, MATLAB настраивает InnerPosition свойство.

  • 'innerposition'InnerPosition свойство остается постоянным, когда вы добавляете, удаляете, или художественные оформления изменения, такие как заголовок или подпись по осям. Если какие-либо позиционные корректировки необходимы, MATLAB настраивает OuterPosition свойство.

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Модули положения в виде одного из этих значений.

UnitsОписание
'normalized'Нормированный относительно контейнера, который обычно является фигурой или панелью. Левый нижний угол контейнера сопоставляет с (0,0) и правый верхний угол сопоставляет с (1,1).
'inches''inches'.
'centimeters''centimeters'.
'characters'

На основе шрифта uicontrol по умолчанию графического корневого объекта:

  • Ширина символов = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points'Точки книгопечатания. Один пункт равен 1/72 дюйма.
'pixels'

  • В системах Windows пиксель составляет 1/72 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • В системах Linux размер пикселя определяется вашим системным разрешением.

При определении модулей как Name,Value пара во время создания объекта, необходимо установить Units свойство прежде, чем задать свойства, что вы хотите использовать эти модули, такие как Position.

Относительная длина модулей данных вдоль каждой оси в виде трехэлементного вектора из формы [dx dy dz]. Этот вектор задает относительный x, y, и z масштабные коэффициенты данных. Например, задавая это свойство как [1 2 1] устанавливает длину одной единицы информации в x - направление быть той же длиной как две единицы информации в y - направление и одна единица информации в z - направление.

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

Пример: ax.DataAspectRatio = [1 1 1]

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

Режим соотношения сторон данных в виде одного из этих значений:

  • 'auto' — Автоматически выберите значения, которые лучше всего используют свободное место. Если PlotBoxAspectRatioMode и CameraViewAngleMode также установлены в 'auto', затем включите "растянуть для заполнения" поведение. Расширьте оси так, чтобы это заполнило свободное место, как задано Position свойство.

  • 'manual' — Отключите "растянуть для заполнения" поведение и используйте вручную заданное соотношение сторон данных. Чтобы задать значения, установите DataAspectRatio свойство.

Относительная длина каждой оси в виде трехэлементного вектора из формы [px py pz] задавая относительную ось X, ось Y и масштабные коэффициенты оси z. Поле графика является полем, заключающим область данных об осях, как задано пределами по осям.

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

Если вы задаете пределы по осям, соотношение сторон данных, и строите соотношение сторон поля, то MATLAB игнорирует соотношение сторон поля графика. Это придерживается соотношения сторон данных и пределов по осям.

Пример: ax.PlotBoxAspectRatio = [1 0.75 0.75]

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

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

  • 'auto' — Автоматически выберите значения, которые лучше всего используют свободное место. Если DataAspectRatioMode и CameraViewAngleMode также установлены в 'auto', затем включите "растянуть для заполнения" поведение. Расширьте Axes возразите так, чтобы это заполнило свободное место, как задано Position свойство.

  • 'manual' — Отключите "растянуть для заполнения" поведение и используйте вручную заданное соотношение сторон поля графика. Чтобы задать значения, установите PlotBoxAspectRatio свойство.

Параметры макета в виде GridLayoutOptions или TiledChartLayoutOptions объект. Это свойство задает опции, когда оси находятся в размещении сетки или мозаичном размещении графика. Если оси не находятся ни в одном типе размещения, то это свойство пусто и не оказывает влияния.

Чтобы расположить оси в определенную строку и столбец размещения сетки, установите Row и Column свойства на GridLayoutOptions объект. Например, этот код помещает оси в третью строку и второй столбец размещения сетки.

g = uigridlayout([4 3]);
ax = uiaxes(g);
ax.Layout.Row = 3;
ax.Layout.Column = 2;

Чтобы заставить оси охватить несколько строк или столбцов, задайте Row или Column свойство как двухэлементный вектор. Например, это исключает столбцы промежутков 2 через 3:

ax.Layout.Column = [2 3];

Представление

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

Азимут и вертикальное изменение представления в виде двухэлементного вектора из формы [azimuth elevation] заданный в модулях степени. В качестве альтернативы используйте view функционируйте, чтобы установить представление.

Пример: ax.View = [45 45]

Тип проекции на 2D экран в виде одного из этих значений:

  • 'orthographic' — Обеспечьте правильные относительные размерности графических объектов относительно расстояния данной точки от средства просмотра и проведите линии, которые параллельны в параллели данных на экране.

  • 'perspective' — Включите видение в перспективе, которое позволяет вам чувствовать глубину в 2D представлениях 3-D объектов. Перспективная проекция не сохраняет относительные размерности объектов. Вместо этого это отображает удаленный линейный сегмент, меньший, чем более близкий линейный сегмент той же длины. Линии, которые параллельны в данных, не могут казаться параллельными на экране.

Местоположение камеры или точка зрения в виде трехэлементного вектора из формы [x y z]. Этот вектор задает координаты осей местоположения камеры, которое является точкой, от которой вы просматриваете оси. Камера ориентирована вдоль оси представления, которая является прямой линией, которая соединяет положение камеры и целевой объект камеры. Для рисунка смотрите Терминологию Графики Камеры.

Если Projection свойство установлено в 'perspective', затем, когда вы изменяете CameraPosition при установке также изменяется сумма перспективы.

В качестве альтернативы используйте campos функционируйте, чтобы установить местоположение камеры.

Пример: ax.CameraPosition = [0.5 0.5 9]

Типы данных: single | double

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

  • 'auto' — Автоматически установите CameraPosition вдоль оси представления. Вычислите положение так, чтобы камера нашлась фиксированное расстояние от цели вдоль азимута и вертикального изменения, заданного текущим представлением, как возвращено view функция. Функции как rotate3d, zoom, и pan, измените этот режим в 'auto' выполнять их действия.

  • 'manual' — Вручную задайте значение. Чтобы задать значение, установите CameraPosition свойство.

Точка целевого объекта камеры в виде трехэлементного вектора из формы [x y z]. Этот вектор задает координаты осей точки. Камера ориентирована вдоль оси представления, которая является прямой линией, которая соединяет положение камеры и целевой объект камеры. Для рисунка смотрите Терминологию Графики Камеры.

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

Пример: ax.CameraTarget = [0.5 0.5 0.5]

Типы данных: single | double

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

  • 'auto' — Расположите целевой объект камеры в центроиде поля графика осей.

  • 'manual' — Используйте вручную заданное значение целевого объекта камеры. Чтобы задать значение, установите CameraTarget свойство.

Вектор, задающий вверх направление в виде трехэлементного вектора направления из формы [x y z]. Для 2D представлений значением по умолчанию является [0 1 0]. Для 3-D представлений значением по умолчанию является [0 0 1]. Для рисунка смотрите Терминологию Графики Камеры.

В качестве альтернативы используйте camup функционируйте, чтобы установить вверх направление.

Пример: ax.CameraUpVector = [sin(45) cos(45) 1]

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

  • 'auto' — Автоматически установите значение к [0 0 1] для 3-D представлений так, чтобы положительный z - направление произошел. Установите значение к [0 1 0] для 2D представлений так, чтобы положительный y - направление произошел.

  • 'manual' — Вручную задайте вектор, задающий вверх направление. Чтобы задать значение, установите CameraUpVector свойство.

Поле зрения в виде скалярного угла, больше, чем 0 и меньше чем или равный 180. Изменение угла поля зрения камеры влияет на размер графических объектов, отображенных в осях, но не влияет на степень перспективного искажения. Чем больше угол, тем больше поле зрения и меньшие объекты кажутся в сцене. Для рисунка смотрите Терминологию Графики Камеры.

Пример: ax.CameraViewAngle = 15

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

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

  • 'auto' — Автоматически выберите поле зрения как минимальный угол, который получает целую сцену, до 180 градусов.

  • 'manual' — Вручную задайте поле зрения. Чтобы задать значение, установите CameraViewAngle свойство.

Интерактивность

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

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

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

Если вы не хотите, чтобы панель инструментов появилась, когда вы наводите на оси пользовательского интерфейса, устанавливаете Visible свойство AxesToolbar возразите против 'off'.

ax = uiaxes;
ax.Toolbar.Visible = 'off';

Для получения дополнительной информации смотрите AxesToolbar Properties.

Взаимодействия в виде массива взаимодействия возражают или пустой массив. Взаимодействия, которые вы задаете, доступны в рамках вашего графика посредством жестов. Вы не должны выбирать кнопки на панели инструментов осей, чтобы использовать их. Например, panInteraction объект включает перетаскивание к панорамированию в рамках графика. Для списка объектов взаимодействия смотрите Интерактивность Диаграммы управления.

Набор по умолчанию взаимодействий зависит от типа графика, который вы отображаете. Можно заменить набор по умолчанию на новый набор взаимодействий, но вы не можете получить доступ или изменить любое из взаимодействий в наборе по умолчанию. Например, этот код заменяет набор по умолчанию взаимодействий с panInteraction и zoomInteraction объекты.

ax = uiaxes;
ax.Interactions = [panInteraction zoomInteraction];

Чтобы удалить все взаимодействия из осей, установите это свойство на пустой массив. Чтобы временно отключить текущий набор взаимодействий, вызовите disableDefaultInteractivity функция. Можно повторно включить им путем вызова enableDefaultInteractivity функция.

Примечание

Объекты взаимодействия не возвращены findobj или findall, и они не копируются copyobj.

Состояние видимости в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Отобразите объект.

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

Местоположение указателя мыши в виде массива 2х3. CurrentPoint свойство содержит (x, y, z) координаты указателя мыши относительно осей. Возвращенный массив имеет форму:

[xfront yfront zfront
 xback  yback  zback]

Две точки указывают на местоположение последнего клика мыши. Однако, если у фигуры есть WindowButtonMotionFcn заданный коллбэк, затем точки указывает на последнее местоположение указателя мыши. У фигуры также есть CurrentPoint свойство.

Значения текущей точки при использовании перспективной проекции могут отличаться от той же точки в ортогональной проекции, потому что форма объема осей может отличаться.

Ортогональная проекция

При использовании ортогональной проекции значения зависят от того, является ли нажатие кнопки в осях или вне осей.

  • Если нажатие кнопки в осях, две точки лежат на линии, которая перпендикулярна плоскости экрана, и это проходит через указатель. Координаты являются точками, где эта линия пересекает поверхности передней и задней части объема осей (который задан осями x, y, и пределами z). Первая строка является точкой, самой близкой к положению камеры. Вторая строка является точкой, самой дальней от положения камеры. Это верно и для 2D и для 3-D представлений.

  • Если нажатие кнопки находится вне осей, но в фигуре, то точки лежат на линии, которая проходит через указатель и перпендикулярна плоскостям целевого объекта камеры и положения камеры. Первая строка является точкой в плоскости положения камеры. Вторая строка является точкой в плоскости целевого объекта камеры.

Перспективная проекция

Нажатие за пределами UIAxes объект в перспективной проекции возвращает переднюю точку как текущее положение камеры. Только задняя точка обновляется с координатами точки, которая находится на расширении линии от положения камеры до указателя и пересечения целевого объекта камеры в той точке.

Контекстное меню в виде ContextMenu объект. Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по объекту. Создайте контекстное меню с помощью uicontextmenu функция.

Примечание

Если PickableParts свойство установлено в 'none' или если HitTest свойство установлено в 'off', затем контекстное меню не появляется.

Состояние выбора в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно истине и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Выбранный. Если вы кликаете по объекту, когда в режиме редактирования графика, то MATLAB устанавливает свой Selected свойство к 'on'. Если SelectionHighlight свойство также установлено в 'on', затем MATLAB отображает маркеры выделения вокруг объекта.

  • 'off' — Не выбранный.

Отображение маркеров выделения, когда выбрано в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно истине и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Отобразите маркеры выделения когда Selected свойство установлено в 'on'.

  • 'off' — Никогда не отображайте маркеры выделения, даже когда Selected свойство установлено в 'on'.

Коллбэки

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

Обратный вызов по клику мыши, заданный как одно из следующих значений:

  • Указатель на функцию

  • Массив ячейки, содержащий указатель на функцию и дополнительные аргументы

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

Используйте это свойство для выполнения кода при клике по объекту. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

  • Объект, по которому кликают — свойства Access объекта, по которому кликают, из функции обратного вызова.

  • Данные о событиях — Пустой аргумент. Замените его на символ тильды (~) в функциональном определении, чтобы указать, что этот аргумент не используется.

Дополнительные сведения о том, как использовать указатели на функцию для определения функций обратного вызова, см. в разделе "Определение обратного вызова".

Примечание

Если PickableParts свойство установлено в 'none' или если HitTest свойство установлено в 'off', затем этот коллбэк не выполняется.

Функция создания объекта в виде одного из этих значений:

  • Указатель на функцию.

  • Массив ячеек, в котором первым элементом является указатель на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Для получения дополнительной информации об определении коллбэка как указатель на функцию, массив ячеек или вектор символов, видит Коллбэки Записи в App Designer.

Это свойство задает функцию обратного вызова, чтобы выполниться, когда MATLAB создает объект. MATLAB инициализирует все значения свойств прежде, чем выполнить CreateFcn 'callback'. Если вы не задаете CreateFcn свойство, затем MATLAB выполняет функцию создания по умолчанию.

Установка CreateFcn свойство на существующем компоненте не оказывает влияния.

Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который создается с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo функционируйте, чтобы получить доступ к объекту.

Функция удаления объекта в виде одного из этих значений:

  • Указатель на функцию.

  • Массив ячеек, в котором первым элементом является указатель на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Для получения дополнительной информации об определении коллбэка как указатель на функцию, массив ячеек или вектор символов, видит Коллбэки Записи в App Designer.

Это свойство задает функцию обратного вызова, чтобы выполниться, когда MATLAB удаляет объект. MATLAB выполняет DeleteFcn коллбэк прежде, чем уничтожить свойства объекта. Если вы не задаете DeleteFcn свойство, затем MATLAB выполняет функцию удаления по умолчанию.

Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который удаляется с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo функционируйте, чтобы получить доступ к объекту.

Контроль выполнения обратного вызова

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

Прерывание коллбэка в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Это свойство определяет, может ли рабочий коллбэк быть прерван. Существует два состояния обратного вызова:

  • Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.

  • Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.

Каждый раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать текущий обратный вызов (если он существует). Interruptible свойство объекта, владеющего рабочим коллбэком, определяет, позволено ли прерывание.

  • Значение 'on' позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит на следующем этапе, где MATLAB обрабатывает очередь, такой как тогда, когда существует a drawnow, figure, uifigure, getframe, waitfor, или pause команда.

    • Если рабочий коллбэк содержит одну из тех команд, то MATLAB останавливает выполнение коллбэка в той точке и выполняет прерывание обратного вызова. MATLAB возобновляет выполнение обратного вызова при завершении прерывания.

    • Если рабочий коллбэк не содержит одну из тех команд, то MATLAB закончил выполнять коллбэк без прерывания.

  • Значение 'off' блоки все попытки прерывания. BusyAction свойство объекта, владеющего прерыванием обратного вызова, определяет, отбрасывается ли прерывание обратного вызова или помещается в очередь.

Примечание

Прерывание и выполнение обратного вызова происходят по-разному в таких ситуациях:

  • Если прерыванием обратного вызова является DeleteFcnCloseRequestFcn или SizeChangedFcn коллбэк, затем прерывание происходит независимо от Interruptible значение свойства.

  • Если рабочий коллбэк является выполняющимся в данным моментом waitfor функция, затем прерывание происходит независимо от Interruptible значение свойства.

  • Timer объекты выполняются согласно расписанию независимо от Interruptible значение свойства.

Когда происходит прерывание, MATLAB не сохраняет состояние свойств или изображения. Например, объект, возвращенный gca или gcf команда может измениться, когда другой коллбэк выполняется.

Постановка в очередь коллбэка в виде 'queue' или 'cancel'. BusyAction свойство определяет, как MATLAB обрабатывает выполнение прерываний обратного вызова. Существует два состояния обратного вызова:

  • Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.

  • Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.

Каждый раз, когда MATLAB инициирует обратный вызов, этот обратный вызов пытается прервать текущий обратный вызов. Interruptible свойство объекта, владеющего рабочим коллбэком, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, владеющего прерыванием обратного вызова, определяет, отбрасывается ли это или вставило очередь. Это возможные значения BusyAction свойство:

  • 'queue' — Помещает прерывание обратного вызова в очередь, чтобы быть обработанным после рабочего выполнения концов коллбэка.

  • 'cancel' — Не выполняет прерывание обратного вызова.

Возможность осуществить захват кликов мыши, заданная как одно из следующих значений:

  • 'visible' — Захватите клики мыши только, когда видимый. Visible свойство должно быть установлено в 'on'. HitTest свойство определяет если UIAxes объект отвечает на нажатие кнопки или если предок делает.

  • 'all' — Захватите клики мыши независимо от видимости. Visible свойство может быть установлено в 'on' или 'off'. HitTest свойство определяет если UIAxes объект отвечает на нажатие кнопки или если предок делает.

  • 'none' — Не может захватить клики мыши. Нажатие на UIAxes возразите передает нажатие кнопки объекту ниже его в текущем представлении окна рисунка, которое обычно является осями или фигурой. HitTest свойство не оказывает влияния.

Если вы хотите объект быть активируемыми кликом мыши, когда это под другими объектами, что вы не хотите быть активируемыми кликом мыши, то установленный PickableParts свойство других объектов к 'none' так, чтобы нажатие кнопки прошло через них.

Ответ на захватил клики мыши в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно истине и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Инициируйте ButtonDownFcn коллбэк UIAxes объект. Если вы задали ContextMenu свойство, затем вызовите контекстное меню.

  • 'off' — Инициируйте коллбэки для самого близкого предка UIAxes объект, который имеет один из них:

    • HitTest набор свойств к 'on'

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

Примечание

PickableParts свойство определяет если UIAxes объект может захватить клики мыши. Если это не может, то HitTest свойство не оказывает влияния.

Это свойство доступно только для чтения.

Состояние Deletion, возвращенное как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство к 'on' когда DeleteFcn коллбэк начинает выполнение. BeingDeleted свойство остается установленным в 'on' пока объект компонента больше не существует.

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

Родительский элемент/Дочерний элемент

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

Родительский контейнер в виде FigureПанель, Tab, GridLayout, или TiledChartLayout объект. Если никакой контейнер не задан, MATLAB вызывает uifigure функция, чтобы создать новый Figure объект, который служит родительским контейнером.

Дочерние элементы, возвращенные как массив графических объектов. Используйте это свойство просмотреть список дочерних элементов или переупорядочить дочерние элементы путем установки свойства на сочетание себя.

Вы не можете добавить или удалить дочерние элементы, использующие Children свойство. Чтобы добавить дочерний элемент в этот список, установите Parent свойство дочернего графического объекта к UIAxes объект.

Видимость указателя на объект в Children свойство родительского элемента в виде одного из этих значений:

  • 'on' — Указатель на объект всегда отображается.

  • 'off' — Указатель на объект невидим в любом случае. Эта опция полезна для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility к 'off' временно скрыть указатель во время выполнения этой функции.

  • 'callback' — Указатель на объект отображается из коллбэков или функций, вызванных коллбэками, но не из функций, вызванных из командной строки. Эта опция блокирует доступ к объекту в командной строке, но разрешает функциям обратного вызова получать доступ к нему.

Если объект не перечислен в Children свойство родительского элемента, затем функционирует, которые получают указатели на объект путем поиска иерархии объектов, или запрос свойств указателя не может возвратить его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.

Скрытые указатели на объекты все еще действительны. Установите корневой ShowHiddenHandles свойство к 'on' перечислять все указатели на объект независимо от их HandleVisibility установка свойства.

Идентификаторы

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

Это свойство доступно только для чтения.

Тип графического объекта, возвращенного как 'axes'.

Идентификатор объекта в виде вектора символов или строкового скаляра. Можно задать уникальный Tag значение, чтобы служить идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте в вашем коде, можно использовать findobj функционируйте, чтобы искать основанное на объектах на Tag значение.

Пользовательские данные в виде любого массива MATLAB. Например, можно задать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Используйте это свойство хранить произвольные данные на объекте.

Если вы работаете в App Designer, создаете публичные или частные свойства в приложении, чтобы осуществлять обмен данными вместо того, чтобы использовать UserData свойство. Для получения дополнительной информации смотрите, Осуществляют обмен данными В рамках Приложений App Designer.

Вопросы совместимости

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

Поведение изменяется в R2020b

Поведение изменяется в R2020b

Поведение изменяется в R2020b

Ошибки, запускающиеся в R2020b

Поведение изменяется в R2020b

Поведение изменяется в R2019b

Поведение изменяется в R2019b

Введенный в R2016a