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.

Коллбэк для изменений выбора, заданный как одно из следующих значений:

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

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

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

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

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

В этой таблице перечислены свойства SelectionChangedEventData объект.

Свойство

Описание

Axes

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

Selection

Текущая выбранная кнопка

PreviousSelection

Ранее выбранная кнопка

Source

AxesToolbar объект

EventName

'SelectionChanged'

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

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

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

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

свернуть все

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

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

Ограничения

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

Введенный в R2018b