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

Использование Функции uitoolbar

Используйте функцию uitoolbar, чтобы добавить пользовательскую панель инструментов на ваш пользовательский интерфейс. Используйте uipushtool и функции uitoggletool, чтобы добавить инструменты нажатия и инструменты переключателя на панель инструментов. Инструмент нажатия функционирует как кнопку. Инструмент переключателя функционирует как кнопку-переключатель. Можно добавить инструменты нажатия и переключить инструменты на стандартную панель инструментов или на пользовательскую панель инструментов.

Синтаксисы для uitoolbar, uipushtool и функций uitoggletool включают следующее:

tbh = uitoolbar(fh,'PropertyName',PropertyValue,...)
pth = uipushtool(tnh,'PropertyName',PropertyValue,...)
tth = uitoggletool(tbh,'PropertyName',PropertyValue,...)

Выходные аргументы, tbh, pth и tth являются указателями, соответственно, получившейся панели инструментов, продвигают инструмент и инструмент переключателя. Смотрите uitoolbar, uipushtool и страницы с описанием uitoggletool для других допустимых синтаксисов.

Последующие темы описывают обычно используемые свойства панелей инструментов и инструментов панели инструментов, предлагают простой пример и обсуждают использование панели инструментов стандарта MATLAB^®:

Commonly Used Properties

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

Для полного списка свойств и для получения дополнительной информации о перечисленных в таблице свойствах, смотрите Toolbar Properties, PushTool Properties и ToggleTool Properties.

Панели инструментов

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

% Create the toolbar
fh = figure;
tbh = uitoolbar(fh);

% Add a push tool to the toolbar
a = [.20:.05:0.95];
img1(:,:,1) = repmat(a,16,1)';
img1(:,:,2) = repmat(a,16,1);
img1(:,:,3) = repmat(flip(a),16,1);
pth = uipushtool(tbh,'CData',img1,...
           'Tooltip','My push tool',...
           'HandleVisibility','off');
% Add a toggle tool to the toolbar
img2 = rand(16,16,3);
tth = uitoggletool(tbh,'CData',img2,'Separator','on',...
           'Tooltip','Your toggle tool',...
           'HandleVisibility','off');

fh является указателем родительской фигуры.

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

CData является 16 16 3 массивами значений между 0 и 1. Это задает изображение истинного цвета, которое отображено на инструменте. Если ваше изображение больше, чем 16 пикселей или в размерности, оно может быть отсечено или вызвать другие нежелательные эффекты. Если массив отсекается, только центр 16 16, часть массива используется.

Tooltip задает подсказки для инструмента нажатия и инструмента переключателя как My push tool и Your toggle tool, соответственно.

В этом примере, устанавливая свойство инструмента Separator переключателя на on создает разделительную линию слева от инструмента переключателя.

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

oldOrder = allchild(tbh);
newOrder = flipud(oldOrder);
tbh.Children = newOrder;

Этот код использует flipud, потому что свойство Children является вектор-столбцом.

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

delete(tth)

При необходимости можно использовать функцию findall, чтобы определить указатели инструментов на конкретной панели инструментов.

toolbarhandle.HandleVisibility = 'off';
toolhandles = toolbarhandle.Children;
toolhandles.HandleVisibility = 'off';

Отображение и изменение стандартной панели инструментов

Можно выбрать, отобразить ли панель инструментов стандарта MATLAB (подсвеченный в красном ниже). Можно также добавить или удалить инструменты из стандартной панели инструментов.

fh.ToolBar = 'figure';  % Display the standard toolbar
fh.ToolBar = 'none';    % Hide the standard toolbar

tbh = findall(fh,'Type','uitoolbar');
tth = uitoggletool(tbh,'CData',rand(20,20,3),...
            'Separator','on',...
            'HandleVisibility','off');

delete(tth)