uiaxes

Создайте оси пользовательского интерфейса для графиков в приложениях

Описание

пример

ax = uiaxes создает оси пользовательского интерфейса в новом окне рисунка и возвращает UIAxes объект. MATLAB® вызывает uifigure функция, чтобы создать фигуру.

пример

ax = uiaxes(Name,Value) задает UIAxes значения свойств с помощью одного или нескольких Name,Value парные аргументы.

пример

ax = uiaxes(parent) создает оси пользовательского интерфейса в заданном родительском контейнере. Родительским элементом может быть Figure созданное использование uifigure функция или один из ее дочерних контейнеров.

ax = uiaxes(parent,Name,Value) задает UIAxes значения свойств с помощью одного или нескольких Name,Value аргументы.

Примеры

свернуть все

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

Создайте окно рисунка с осями пользовательского интерфейса и присвойте UIAxes возразите против переменной ax. Добавьте линейный график в оси путем определения UIAxes возразите как первый входной параметр для plot функция.

fig = uifigure;
ax = uiaxes(fig);
x = linspace(-pi,pi,50);
y = 5*sin(x);
plot(ax,x,y)

Установите состояние удержания на и добавьте график рассеивания. Задайте UIAxes возразите как первый входной параметр для hold и scatter функции.

hold(ax,'on')
y2 = 5*sin(x) + randn(1,50);
scatter(ax,x,y2)

Измените внешний вид осей пользовательского интерфейса путем установки аргументов пары "имя-значение" использования свойств. Например, инвертируйте направление оси X с помощью XDir пара "имя-значение".

fig = uifigure;
ax = uiaxes(fig,'XDir','reverse');
x = linspace(-pi,pi);
y = sin(x);
plot(ax,x,y)

В качестве альтернативы задайте свойства после того, как оси будут созданы с помощью записи через точку. Например, инвертируйте направление оси Y с помощью записи через точку, чтобы получить доступ к YDir свойство.

ax.YDir = 'reverse';

Задайте положение осей пользовательского интерфейса путем установки Position свойство. Задайте положение в пикселях.

fig = uifigure;
ax = uiaxes(fig,'Position',[10 10 550 400]);

Добавьте оси пользовательского интерфейса в панель в рамках окна рисунка. Задайте панель и положения осей в пикселях.

fig = uifigure;
p = uipanel(fig,'Position',[10 10 400 400]);
ax = uiaxes(p,'Position',[10 10 390 390]);

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

свернуть все

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

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

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

Пример: 'Xscale','linear','YScale','log'

Список свойств здесь является только подмножеством. Для полного списка смотрите UIAxes Properties.

Минимум и максимум ограничивают в виде двухэлементного вектора формы [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

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

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

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

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

'log'

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

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

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

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

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

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

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

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

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

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

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

Выходные аргументы

свернуть все

UIAxes объект. Используйте ax установить свойства UIAxes после того, как они создаются.

Советы

  • Изменение масштаба, панорамирование, и вращаются, режимы только поддерживают подмножество опций для осей пользовательского интерфейса. zoom только поддерживает on'off', и масштабируйте факторные аргументы. rotate3d и pan только поддержите on и off аргументы. Рекомендуемый способ взаимодействовать с графиками в осях пользовательского интерфейса состоит в том, чтобы использовать панель инструментов осей или встроенные взаимодействия осей. Для получения дополнительной информации смотрите Интерактивность Диаграммы управления.

Смотрите также

Функции

Свойства

Введенный в R2016a

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