axtoolbar

Создайте панель инструментов осей

Описание

пример

tb = axtoolbar(buttons) заменяет панель инструментов по умолчанию, которая появляется выше верхнего правого угла текущей системы координат с панелью инструментов, которая содержит только заданные кнопки. Например, axtoolbar({'pan','restoreview'}) задает кнопку к панорамированию и кнопку, чтобы восстановить исходное представление. Функция возвращает AxesToolbar объект создается.

пример

tb = axtoolbar(ax,buttons) заменяет панель инструментов для осей или размещенного рядом размещения графика, заданного ax, вместо текущей системы координат.

tb = axtoolbar заменяет панель инструментов для текущей системы координат с пустой панелью инструментов.

tb = axtoolbar(ax) заменяет панель инструментов для заданных осей или размещенного рядом размещения графика с пустой панелью инструментов, вместо текущей системы координат.

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

[tb,btns] = axtoolbar(___) также возвращает созданные объекты кнопки на панели инструментов, которые являются любой ToolbarStateButton, ToolbarPushButton, или ToolbarDropdown объекты. Можно использовать объекты изменить кнопки на панели инструментов и кнопки на панели инструментов после того, как вы создадите их.

Примеры

свернуть все

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

plot(magic(5))
[tb,btns] = axtoolbar({'zoomin','zoomout','restoreview'});

Figure with zoom in, zoom out, and restore view buttons in the axes toolbar

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

Во-первых, создайте два подграфика и присвойте Axes объекты к переменным ax1 и ax2. Замените панель инструментов для верхнего подграфика с пользовательской панелью инструментов путем определения ax1 как первый входной параметр к axtoolbar функция. Затем замените панель инструментов для более низкого подграфика. Наведите на каждый подграфик, чтобы видеть его панель инструментов.

ax1 = subplot(2,1,1);
plot(ax1,magic(5))
[tb1,btns1] = axtoolbar(ax1,{'zoomin','zoomout','restoreview'});

ax2 = subplot(2,1,2);
plot(ax2,magic(5))
[tb2,btns2] = axtoolbar(ax2,{'pan','datacursor'});

Figure with two plots. The bottom plot has data tip and pan buttons in the axes toolbar.

Создайте мозаичное размещение графика с одной панелью инструментов осей.

Во-первых, создайте 2 1 размещение и отобразите различный график в каждой мозаике. Затем создайте пользовательскую панель инструментов осей для мозаичного размещения графика. Отобразите панель инструментов путем наведения на размещение.

t = tiledlayout(2,1);
nexttile
plot(magic(5));
nexttile
plot(magic(5));

tb = axtoolbar(t,{'zoomin','zoomout','restoreview'});

Figure with two plots. The top plot has zoom in, zoom out, and restore view buttons in the axes toolbar.

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

свернуть все

Целевые оси в виде одного из следующего:

  • Axes объект – Создает пользовательскую панель инструментов осей для заданного набора осей.

  • TiledChartLayout объект – Создает одну панель инструментов осей, которая применяется ко всем осям в заданном мозаичном размещении графика.

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

Имя кнопкиЗначокОписание
'export'Export icon

Меню отображения опций экспорта.

'brush'Data brushing iconПереключите режим окрашивания данных.
'datacursor'Data tips iconПереключите режим Data Cursor.
'rotate'Переключатель вращает режим.
'pan'Pan iconПереключите режим панорамирования.
'zoomin'Zoom in iconПереключите увеличение режима.
'zoomout'Zoom out iconПереключите уменьшение режима.
'restoreview'Восстановите исходное представление осей или размещенного рядом размещения графика.

Наведение на 'export' кнопка показывает выпадающее меню с опциями для экспорта осей или размещенного рядом содержимого размещения графика:

  • Save as icon: Сохраните содержимое как плотно кадрированное изображение или PDF.

  • Copy as image icon: Скопируйте содержимое как изображение.

  • Copy as vector graphic icon: Скопируйте содержимое как векторное изображение.

Пример: axtoolbar({'zoomin','zoomout','restoreview'})

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

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

Пример: axtoolbar({'zoomin','zoomout'},'SelectionChangedFcn',@mycallback)

Примечание

Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите AxesToolbar Properties.

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

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

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

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

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

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии с кнопками. MATLAB передает эту информацию в SelectionChangedEventData возразите в качестве второго аргумента против своей функции обратного вызова. Вы можете запросить свойства объекта с помощью записи через точку. Например, event.Selection возвращает в настоящее время нажатую кнопку. SelectionChangedEventData объект не доступен для функций обратного вызова, заданных как векторы символов.

Эта таблица приводит свойства SelectionChangedEventData объект.

Свойство

Описание

Axes

Массив Axes объекты сопоставлены с панелью инструментов

Selection

В настоящее время нажатая кнопка

PreviousSelection

Ранее нажатая кнопка

Source

AxesToolbar объект

EventName

'SelectionChanged'

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

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

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

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

свернуть все

Панель инструментов, возвращенная как AxesToolbar объект. Используйте tb изменить панель инструментов после того, как вы создаете его. Для списка свойств смотрите AxesToolbar Properties.

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

Ограничения

  • Пользовательские панели инструментов не кажутся в цифрах в Live Editor. Чтобы видеть пользовательскую панель инструментов, откройте фигуру в отдельном окне рисунка путем нажатияOpen in Figure Window кнопки в верхнем правом углу фигуры.

Введенный в R2018b