uitoolbar

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

Описание

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.

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

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.

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

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

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.

Создайте инструмент push на панели инструментов. Установите 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.

Создайте синий массив изображений truecolor. Установите 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'.

Примечание

Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойств панели инструментов».

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

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

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

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

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

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

toolOrder = tb.Children
toolOrder = 

  2×1 graphics array:

  ToggleTool
  PushTool

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

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

Совет

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

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

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