Exponenta Banner

uitoolbar

Создайте панель инструментов на фигуре

свернуть все на странице

Синтаксис

tb = uitoolbar
tb = uitoolbar(parent)
tb = uitoolbar(___,Name,Value)

Описание

tb = uitoolbar создает панель инструментов на текущей фигуре и возвращает Toolbar объект. Если фигура, созданная с figure функция не существует, затем MATLAB® создает, чтобы служить родительским элементом.

пример

tb = uitoolbar(parent) создает панель инструментов на заданной родительской фигуре. Родительский контейнер может быть фигурой, созданной с любым uifigure или figure функция.

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

Примеры

свернуть все

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

f = figure;
tb = uitoolbar(f);

Figure that displays the default toolbar and another empty toolbar below it.

Создайте инструмент нажатия на панели инструментов. Считайте новый значок из индексируемого файла изображения, matlabicon.gif. Преобразуйте индексируемое изображение в матрицу изображений истинного цвета RGB. Добавьте, что значок к нажатию оснащает его путем установки CData свойство к матрице изображений истинного цвета.

pt = uipushtool(tb);

[img,map] = imread(fullfile(matlabroot,...
            'toolbox','matlab','icons','matlabicon.gif'));
ptImage = ind2rgb(img,map);

pt.CData = ptImage;

Figure that displays the default toolbar and another toolbar below it that contains a push tool with the MathWorks logo.

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

Создайте фигуру пользовательского интерфейса. Добавьте панель инструментов на него. Затем добавьте инструмент инструмента и переключателя нажатия в панель инструментов.

fig = uifigure;
tb = uitoolbar(fig);
pt = uipushtool(tb);
tt = uitoggletool(tb);

UI figure with a push tool and toggle tool in a toolbar that both display the default icon.

Создайте инструмент нажатия на панели инструментов. Установите Icon значение свойства к файлу изображения matlabicon.gif.

pt.Icon = fullfile(matlabroot,'toolbox','matlab','icons','matlabicon.gif');

Membrane logo added to the push tool. The push tool is to the left of the toggle tool.

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

ttImage = zeros(16,16,3);
ttImage(:,:,3) = ones(16);
tt.Icon = ttImage;

Blue square added to the toggle tool.

Запросите Children свойство панели инструментов. Порядок дочерних элементов, возвращенных в этом массиве, отражается справа налево порядок инструментов, отображенных на панели инструментов. Инструмент переключателя является самым правым инструментом и появляется наверху списка (первый элемент массива).

oldToolOrder = tb.Children
oldToolOrder = 

  2×1 graphics array:

  ToggleTool
  PushTool

Инвертируйте порядок инструментов путем вызова flipud функция, чтобы инвертировать порядок элементов в массиве, возвращенном tb.Children. Установите Children значение свойства к этому новому порядку инструмента. Инструмент нажатия теперь появляется справа от инструмента переключателя на панели инструментов.

newToolOrder = flipud(oldToolOrder);
tb.Children = newToolOrder;

Blue toggle tool appears to the left of the push tool in the toolbar.

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

свернуть все

Родительская фигура в виде Figure объект, созданный с любым uifigure или figure функция. Если родительская фигура не задана, то MATLAB вызывает figure функция, чтобы создать ту, которая служит родительским элементом.

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

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

Пример: 'Visible','off' устанавливает видимость панели инструментов на 'off'.

Примечание

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

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

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

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

Чтобы заставить ваше приложение запуститься быстрее, установите Visible свойство к 'off' для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.

Toolbar дочерние элементы, возвращенные как пустой GraphicsPlaceholder или 1D массив объектов компонента. Дочерние элементы Toolbar объектами является PushTool и ToggleTool объекты.

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

toolOrder = tb.Children
toolOrder = 

  2×1 graphics array:

  ToggleTool
  PushTool

Чтобы добавить дочерний элемент в этот список, установите Parent свойство дочернего компонента к uitoolbar объект.

Объекты с HandleVisibility набор свойств к 'off' не перечислены в Children свойство.

Советы

  • Панели инструментов могут содержать инструменты нажатия или переключить инструменты. Инструменты нажатия ведут себя как кнопки. Когда вы кликаете по ним, они, кажется, снижают, пока вы не отпускаете кнопку мыши. Переключитесь инструменты имеют два состояния: 'off' или 'on'. Состояние кнопки изменяется каждый раз, когда вы кликаете по нему.

  • Toolbar объекты (и их дочерний PushTool и ToggleTool объекты), не кажутся в цифрах чей WindowStyle свойство установлено в 'modal'. Если у фигуры, содержащей дочерний элемент панели инструментов, есть ее WindowStyle измененный на 'modal', дочерний элемент панели инструментов все еще существует в Children свойство фигуры. Однако панель инструментов не появляется в то время как WindowStyle установлен в 'modal'.

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

Функции

Свойства

Представлено до R2006a

Документация MATLAB

Поддержка