axtoolbarbtn

Добавьте кнопки к панели инструментов осей

Синтаксис

btn = axtoolbarbtn(tb)
btn = axtoolbarbtn(tb,style)
btn = axtoolbarbtn(tb,style,Name,Value)

Описание

btn = axtoolbarbtn(tb) добавляет кнопку к панели инструментов осей, заданной tb, и возвращает объект ToolbarPushButton.

пример

btn = axtoolbarbtn(tb,style) добавляет или кнопку или кнопку состояния на панель инструментов, заданную tb, и возвращает объект кнопки. Для кнопки, набор стиль к 'push'. Для кнопки состояния с двумя состояниями, набор стиль к 'state'.

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

Примеры

свернуть все

Добавьте пользовательскую кнопку состояния для панели инструментов осей, которая включает и выключает линии сетки осей.

Во-первых, создайте программный файл под названием mycustomstatebutton.m m. В программном файле:

  • Отобразите случайные данные на графике.

  • Создайте панель инструментов для осей с опциями, чтобы увеличить масштаб, уменьшить масштаб, и восстановить представление с помощью функции axtoolbar.

  • Добавьте пустую кнопку состояния к панели инструментов с помощью функции axtoolbarbtn. Возвратите объект ToolbarStateButton.

  • Задайте значок, подсказку и функцию обратного вызова для кнопки состояния путем установки Icon, Tooltip и свойств ValueChangedFcn. Этот пример использует значок, который необходимо сначала сохранить как файл изображения под названием mygridicon.png на пути.

Когда вы запустите программный файл, кликните по значку, чтобы включить и выключить линии сетки.

function mycustomstatebutton

plot(rand(5))
ax = gca;
tb = axtoolbar(ax,{'zoomin','zoomout','restoreview'});

btn = axtoolbarbtn(tb,'state');
btn.Icon = 'mygridicon.png';
btn.Tooltip = 'Grid Lines';
btn.ValueChangedFcn = @customcallback;

    function customcallback(src,event)
        switch src.Value
            case 'off'
                event.Axes.XGrid = 'off';
                event.Axes.YGrid = 'off';
                event.Axes.ZGrid = 'off';
            case 'on'
                event.Axes.XGrid = 'on';
                event.Axes.YGrid = 'on';
                event.Axes.ZGrid = 'on';
        end
    end

end

Создайте пользовательскую кнопку для панели инструментов осей, которая привязывает представление осей к 2D представлению.

Во-первых, создайте программный файл под названием mycustompushbutton.m m. В программном файле:

  • Постройте график поверхности.

  • Создайте панель инструментов для осей с опциями, чтобы увеличить масштаб, уменьшить масштаб, вращать, и восстановить представление с помощью функции axtoolbar.

  • Добавьте пустую кнопку к панели инструментов с помощью функции axtoolbarbtn. Возвратите объект ToolbarPushButton.

  • Задайте значок, подсказку и функцию обратного вызова для кнопки путем установки Icon, Tooltip и свойств ButtonPressedFcn, соответственно. Этот пример использует значок, который необходимо сначала сохранить как файл изображения под названием my2dicon.png на пути.

Когда вы запустите программный файл, кликните по значку, чтобы привязать представление осей к 2D представлению.

function mycustompushbutton

surf(peaks(25))
ax = gca;
tb = axtoolbar(ax,{'zoomin','zoomout','rotate','restoreview'});

btn = axtoolbarbtn(tb,'push');
btn.Icon = 'my2dicon.png';
btn.Tooltip = 'Snap to 2-D view';
btn.ButtonPushedFcn = @customcallback;

    function customcallback(src,event)
        view(event.Axes,2)
    end

end

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

свернуть все

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

Стиль кнопки, заданный как одна из этих опций.

СтильОписание
'push'Кнопка. Когда кликнувшийся однажды, кнопка, кажется, нажимает и выпускает.
'state'Кнопка состояния с двумя состояниями. Когда кликнувшийся однажды, кнопка остается в нажатом или выпущенном состоянии, пока по этому не щелкают еще раз.

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

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

Пример: axtoolbarbtn (TB, 'нажатие', 'Значок', 'myimage.png', 'Подсказка', 'Моя Подсказка Значка')

Примечание

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

Значок кнопки, заданный как одно из этих значений:

  • Имя файла — Задает имя файла как вектор символа или скаляр строки. Имя файла может быть файлом изображения на пути или полном пути к файлу изображения. Тип файла изображения должен быть JPEG, GIF или PNG. MATLAB уменьшает масштаб изображения, чтобы соответствовать при необходимости.

  • Массив — Задает m n 3 массивами триплетов RGB.

  • Матрица — Задает матрицу m на n числовых значений.

    • Если значения имеют целый тип, то задают значения между 0 и 63. Значение 0 является самым темным цветом, и значение 63 прозрачно. NaN также прозрачен.

    • Если значения имеют тип double, то задают значения между 1 и 64. Значение 1 является самым темным цветом, и значение 64 прозрачно. NaN также прозрачен.

  • Предопределенный значок — Задает одно из имен в этой таблице.

    Имя значкаРезультат
    кисть

    'datacursor'

    вращение

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

    'zoomin'

    'zoomout'

    'restoreview'

    'none'Никакой значок

Пример: btn. Значок = 'icon.png'

Пример: btn. Значок = 'C:\Documents\icon.png'

Пример: btn. Значок = 'вращает'

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

Пример: btn. Подсказка = 'Моя Подсказка'

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

Функции

Свойства

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

Была ли эта тема полезной?