uipushtool
在工具栏中创建按钮工具
说明
pt = uipushtoolPushTool 对象。
如果当前图窗没有子工具栏，则 MATLAB® 会在当前图窗中创建一个工具栏作为父级。如果用 figure 函数创建的图窗不存在，则 MATLAB 会创建一个图窗，并调用 uitoolbar 函数来创建一个工具栏作为父级。
按钮工具的行为就像普通按钮。当您点击它们时，它们显示为已按下，直到您松开鼠标按键。
pt = uipushtool(___,Name,Value)
示例
通过调用 uifigure 函数创建一个 UI 图窗。在 UI 图窗中创建一个工具栏。
fig = uifigure; tb = uitoolbar(fig);
向该工具栏添加一个按钮工具。按钮工具显示默认图标。
pt = uipushtool(tb);
通过将 Icon 属性设置为图像文件 peppers.png，为按钮工具添加一个图标。
pt.Icon = "peppers.png";
通过调用 figure 函数来创建一个图窗。向图窗添加一个工具栏。它出现在默认图窗工具栏下方。
f = figure; tb = uitoolbar(f);
在工具栏中创建一个按钮工具。从索引图像文件 matlabicon.gif 中读取一个新图标。将索引图像转换为 RGB 真彩色图像数组。通过将 CData 属性设置为真彩色图像数组，为按钮工具添加图标。
pt = uipushtool(tb); [img,map] = imread(fullfile(matlabroot,... 'toolbox','matlab','icons','matlabicon.gif')); ptImage = ind2rgb(img,map); pt.CData = ptImage;
创建一个按钮工具，当您点击它时，它将打开 uisetcolor 对话框。将 UI 图窗的背景颜色更改为从颜色选择器中选择的颜色。
首先，创建一个名为 colorPickerPushTool.m 的程序文件。在该程序文件中：
创建一个 UI 图窗。
在 UI 图窗中创建一个工具栏。
在工具栏中创建一个按钮工具。
通过将
Icon属性值设置为paintbrush.gif的完整文件路径，为按钮工具添加一个适当的图标。为按钮工具创建一个工具提示。
将
ClickedCallback属性设置为引用名为colorToolClicked的回调函数的函数句柄。创建一个名为
colorToolClicked的回调函数。在其中调用uisetcolor函数，这样当您点击工具栏中的按钮工具时，会打开颜色选择器对话框。将颜色选择器的默认颜色设置为 UI 图窗的颜色，并将颜色选择器的标题指定为'Select UI Figure Color'。使 UI 图窗成为当前图窗，以便它显示在所有其他图窗的前端。
function colorPickerPushTool fig = uifigure('Position',[350 500 400 300]); tb = uitoolbar(fig); pt = uipushtool(tb); pt.Icon = fullfile(matlabroot,'toolbox','matlab','icons','paintbrush.gif'); pt.Tooltip = 'Change UI Figure Color'; pt.ClickedCallback = @colorToolClicked; function colorToolClicked(src,event) c = uisetcolor(fig,'Select UI Figure Color'); figure(fig) end end
运行 colorPickerPushTool。点击按钮工具打开颜色选择器。然后，选择一种颜色来更改 UI 图窗的背景颜色。
colorPickerPushTool
输入参数
名称-值参数
提示
在
WindowStyle属性设置为'modal'的图窗中，Toolbar对象（及其子级PushTool和ToggleTool对象）不显示。如果一个含有工具栏子对象的图窗的WindowStyle更改为'modal'，则该工具栏子对象仍然存在于图窗的Children属性中。但是，在WindowStyle设置为'modal'时，工具栏不会出现。与
UIControl普通按钮不同，在第二次点击时，按钮工具不会将图窗的SelectionType属性设置为'open'。
