axtoolbarbtn

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

Описание

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

пример

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

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

Примеры

свернуть все

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

Во-первых, создайте программный файл под названием mycustomstatebutton.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. В программном файле:

  • Постройте поверхность.

  • Создайте панель инструментов для осей с опциями, чтобы увеличить масштаб, уменьшить масштаб, вращать, и восстановить представление с помощью 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 аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: axtoolbarbtn(tb,'push','Icon','myimage.png','Tooltip','My Icon Tooltip')

Примечание

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

Значок кнопки, заданный как одно из этих значений. Панель инструментов осей отображает значки как полутоновые изображения. MATLAB® уменьшает масштаб изображения, чтобы соответствовать при необходимости.

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

  • Массив — Задает m n 3 массивами триплетов RGB, которые представляют пиксели в изображении.

  • Матрица — Задает матрицу m на n числовых значений, которые представляют пиксели в изображении.

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

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

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

    Имя значкаРезультат
    'brush'

    'datacursor'

    'export'

    'rotate'

    'pan'

    'zoomin'

    'zoomout'

    'restoreview'

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

Пример: btn.Icon = 'icon.png'

Пример: btn.Icon = 'C:\Documents\icon.png'

Пример: btn.Icon = 'rotate'

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

Пример: btn.Tooltip = 'My Tooltip'

Введенный в R2018b