Exponenta Banner
exponenta event banner

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' для набора по умолчанию кнопок или массива ячеек, содержащего одно или несколько имен кнопки. Имена кнопки включают:

  • кисть

  • 'datacursor'

  • вращение

  • панорамирование

  • 'zoomin'

  • 'zoomout'

  • 'restoreview'

Кнопки появляются в стандартном порядке на панель инструментов независимо от порядка, в котором вы задаете их. Каждая кнопка может появиться только однажды на панели инструментов.

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

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

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

Примечание

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

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

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

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

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

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

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

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

Свойство

Описание

Оси

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

Selection

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

PreviousSelection

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

Source

Объект AxesToolbar

EventName

'SelectionChanged'

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

  • 'on' — Отображать объект.

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

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

свернуть все

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

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

Ограничения

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

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

Функции

Свойства

Представленный в R2018b

Была ли эта тема полезной?
Документация MATLAB
Поддержка