exponenta event banner

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 object - создание панели инструментов пользовательских осей для указанного набора осей.

  • TiledChartLayout object - создание панели инструментов для отдельных осей, которая применяется ко всем осям в указанной компоновке мозаичной диаграммы.

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

Имя кнопкиСимволОписание
'export'Export icon

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

'brush'Data brushing iconПереключение режима чистки данных.
'datacursor'Data tips iconПереключение режима курсора данных.
'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 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Просмотр объекта.

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

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

свернуть все

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

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

Ограничения

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

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