axtoolbar

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

Синтаксис

tb = axtoolbar(buttons)
tb = axtoolbar(ax,buttons)
tb = axtoolbar
tb = axtoolbar(ax)
tb = axtoolbar(___,Name,Value)
[tb,btns] = 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. Можно использовать объекты изменить кнопки на панели инструментов и кнопки на панели инструментов после того, как вы создадите их.

Примеры

свернуть все

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

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

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

Во-первых, создайте два подграфика и присвойте объекты 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'});

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

свернуть все

Целевые оси, заданные как объект Axes.

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

Имя кнопкиЗначокОписание
'export'Сохраните оси как плотно кадрированное изображение или файл PDF
'brush'Переключите режим окрашивания данных
'datacursor'Переключите режим Data Cursor
'rotate'Переключатель вращает режим
'pan'Переключите режим панорамирования
'zoomin'Переключите увеличение режима
'zoomout'Переключите уменьшение режима
'restoreview'Восстановите исходное представление осей

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

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (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' — Скрыть объект, не удаляя его. Вы по-прежнему можете получать доступ к свойствам невидимого объекта.

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

свернуть все

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

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

Ограничения

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

Введенный в R2018b

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