exponenta event banner

uiaxes

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

Описание

пример

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

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

пример

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, Panel, Tab, GridLayout, или TiledChartLayout объект. Если контейнер не указан, MATLAB вызывает uifigure для создания новой функции Figure объект, который служит родительским контейнером.

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

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

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

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

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

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

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

Масштаб оси, заданный как одно из этих значений.

СтоимостьОписаниеРезультат
'linear'

Линейный масштаб

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

'log'

Шкала журнала

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

Примечание

В некоторых случаях оси могут исключать координаты:

  • Если координаты содержат положительные и отрицательные значения, отображаются только положительные значения.

  • Если все координаты отрицательные, все значения отображаются на шкале журнала с соответствующим знаком.

  • Нулевые значения не отображаются.

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

Стиль линииОписаниеРезультирующая линия
'-'Сплошная линия

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

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

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

'none'Без строкиБез строки

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

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

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

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

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

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

2-D Вид осей3-D Вид осей

Примечание

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

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

свернуть все

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

Подробнее

свернуть все

Различия между UIAxes и Axes Объекты

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

СобственностьUIAxes ОбъектыAxes Объекты
NextPlot

Значение по умолчанию: 'replacechildren'.

Значение по умолчанию: 'replace'.

Position

Дефолт Position является [10 10 400 300] в пикселях.

Position свойство эквивалентно OuterPosition собственность.

Дефолт Position является [0.1300 0.1100 0.7750 0.8150] в нормированных единицах.

Position свойство эквивалентно InnerPosition собственность.

Units

Значение по умолчанию: 'pixels'.

Значение по умолчанию: 'normalized'.

FontUnits

Значение по умолчанию: 'pixels'.

Значение по умолчанию: 'points'.

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