Axes Properties

Внешний вид и поведение осей

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

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

ax = gca;
c = ax.Color;
ax.Color = 'blue';

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

Шрифт

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 свойство так, чтобы Axes объект правильно интерпретирует заданный размер шрифта.

Символьное сглаживание, заданное как 'on' или 'off'.

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

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

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

'off'

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

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

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

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

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

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

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

В качестве альтернативы используйте xticksyticks, и 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 использует значения в массиве, не категории.

Как альтернатива установке этого свойства, можно использовать xticklabelsyticklabels, и 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, чтобы добавить верхние индексы и индексы, изменить тип текста и окрасить и включать специальные символы в текст.

Таблица, которая следует, приводит поддерживаемые модификаторы когда TickLabelInterpreter свойство установлено в '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}Установите specifer как один из этих цветов: red, green, yellowПурпурный, blue, black, whiteсерый, darkGreen, orange, или lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Установите specifier как трехэлементный триплет RGB, чтобы изменить цвет шрифта.'\color[rgb]{0,0.5,0.5} text'

Эта таблица приводит поддерживаемые специальные символы с Interpreter набор свойств к 'tex'.

Последовательность символовСимволПоследовательность символовСимволПоследовательность символовСимвол

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

Разметка LaTeX

Чтобы использовать разметку LATEX, установите TickLabelInterpreter свойство к 'latex'. Используйте долларовые символы вокруг текста, например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

Отображаемый текст использует стиль шрифта LATEX по умолчанию. Чтобы изменить стиль шрифта, используйте разметку LATEX в рамках текста. FontNameFontWeight , и FontAngle свойства не оказывают влияния.

Максимальный размер текста, который можно использовать с интерпретатором LATEX, является 1 200 символами. Для многострочного текста этот предел уменьшает приблизительно на 10 символов на строку. Для получения дополнительной информации о системе LATEX, смотрите веб-сайт Проекта LATEX по www.latex-project.org.

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

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

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

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

Незначительные отметки деления, заданные как одно из этих значений:

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

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

Пример: 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]

В качестве альтернативы используйте xlimylim, и 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 создает для каждой оси, зависит от отображенных на графике данных. Для списка свойств линейки, что Axes поддержка объектов, см.:

Например, получите доступ к линейке для оси 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 = 'y'

Пример: ax.ZColor = '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'

Сетки

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

Линии сетки, заданные как одно из этих значений:

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

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

В качестве альтернативы используйте 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 = 'b'

Пример: 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'

Незначительные линии сетки, заданные как одно из этих значений:

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

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

В качестве альтернативы используйте 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 = 'b'

Пример: 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 = gca;
ax.Title.String = 'My Title';
ax.Title.FontWeight = 'normal';

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

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

Примечание

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

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

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

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

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

Примечание

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

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

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

plot(rand(3))
legend({'Line 1','Line 2','Line 3'},'FontSize',12)
ax = gca;
ax.Legend.TextColor = 'red';

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

ax = gca;
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 может изменить цвета графика и стили линии.

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

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

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

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

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

Примечание

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

Фигуры также имеют 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 задает значение данных, которое сопоставляет с последним альфа-значением в альфа-карте фигуры.

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

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

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

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

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

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

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

Цвет фона, заданный как триплет 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'

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

Пример: ax.Color = 'b';

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

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

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

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

Схема поля, заданная как 'off' или 'on'.

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

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

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

'on'

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

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

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

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

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

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

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

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

'full'

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

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

Усечение объектов к пределам осей, заданным как любой 'on' или 'off'. Поведение усечения объекта в 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 = 'm'

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

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

Положение

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

Размер и местоположение, включая метки и поле, заданное как четырехэлементный вектор формы [left bottom width height]. По умолчанию MATLAB измеряет значения в модулях, нормированных к контейнеру. Чтобы изменить модули, установите Units свойство. Значение по умолчанию [0 0 1 1] включает целую внутреннюю часть контейнера.

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

  • width и height элементы являются внешними размерностями контура положения.

Эти рисунки показывают области, заданные OuterPosition (синие) значения и Position (красные) значения.

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

Для получения дополнительной информации о положении осей смотрите Размещение Осей Управления.

Примечание

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

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

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

  • width и height элементы являются размерностями контура положения. Для осей в 3-D представлении, Position свойство является наименьшим прямоугольником, который заключает оси.

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

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

Для получения дополнительной информации о положении осей смотрите Размещение Осей Управления.

Примечание

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

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

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

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

Эти рисунки показывают области, заданные OuterPosition (синие) значения, Position (красные) значения, и Position расширенный TightInset значения (пурпурный).

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

Для получения дополнительной информации смотрите Размещение Осей Управления.

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

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

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

Примечание

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

Модули положения, заданные как одно из этих значений.

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

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

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

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

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

'pixels'.

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

  • В системах 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 свойство.

Параметры макета, заданные как TiledChartLayoutOptions объект. Это свойство задает опции, когда оси являются дочерним элементом мозаичного размещения графика. Используйте это свойство расположить оси в размещении путем установки Tile и TileSpan свойства на TiledChartLayoutOptions объект.

Например, этот код помещает оси ax в третьей мозаике мозаичного размещения графика.

ax.Layout.Tile = 3;

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

ax.Layout.TileSpan = [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изменение масштаба, и 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 = gca;
ax.Toolbar.Visible = 'off';

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

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

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

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

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

Примечание

  • Установка этого свойства не поддержана в Live Editor.

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

Состояние видимости, заданное в качестве одного из следующих значений:

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

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

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

[xfront yfront zfront
 xback  yback  zback]

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

Коллбэки

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Прерывание коллбэка, заданное как 'on' или 'off'. Interruptible свойство определяет, может ли рабочий коллбэк быть прерван.

Существует два состояния обратного вызова:

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

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

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

  • 'on' — Позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит на следующем этапе, где MATLAB обрабатывает очередь, такой как тогда, когда существует drawnowфигураФигура пользовательского интерфейсаgetframewaitfor, или 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 свойство определяет если Axes объект отвечает на нажатие кнопки или если предок делает.

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

Родительский контейнер, заданный как FigureПанель, Tab, или TiledChartLayout объект.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для просмотра документации необходимо авторизоваться на сайте