主要内容

Uipushtool.

在工具栏中创建推工具

描述

pt= uipushtool在当前图形的工具栏中创建一个推送工具,并返回PushTool对象。

属性创建的当前图形数字函数。如果当前图形没有子工具栏,则MATLAB®在当前图中创建一个函数作为父函数。如果使用数字函数不存在,则MATLAB创建一个并调用uitoolbar函数创建一个工具栏作为父工具栏。

推工具的行为就像推按钮。当你点击它们时,它们会显示为按压状态,直到你松开鼠标按钮。

例子

pt= uipushtool (在指定的父工具栏中创建推工具。

例子

pt= uipushtool (___名称,值创建带有使用一个或多个名称-值对参数指定的属性值的推送工具。使用前面的任一语法指定名称-值对。

例子

全部折叠

的方法创建一个UI图形uifigure函数。在UI图中创建一个工具栏。

无花果= uifigure;结核病= uitoolbar(图);

带有空工具栏的UI图。

添加一个推工具到工具栏。推送工具显示默认图标。

pt = uipushtool(结核病);

UI图形,显示带有默认图标的工具栏和推工具。

添加一个图标到推工具通过设置图标属性值设置为图像文件greencircleicon.gif

pt.Icon = fullfile (matlabroot,“工具箱”matlab的“图标”'greencircleicon.gif');

显示带有绿色圆形图标的工具栏和推工具的UI图形。

创建一个图形,调用数字函数。向图中添加工具栏。它出现在默认图形工具栏的下方。

f =图;结核病= uitoolbar (f);

图中显示了默认工具栏和它下面的另一个空工具栏。

在工具栏中创建一个推工具。从索引的图像文件中读取一个新图标,matlabicon.gif..将索引图像转换为RGB真彩色图像数组。将图标添加到推工具通过设置CData属性设置为真彩色图像数组。

pt = uipushtool(结核病);[img,map] = imread(fullfile(matlabroot,...“工具箱”matlab的“图标”“matlabicon.gif”));ptImage = ind2rgb (img,地图);pt.CData = ptImage;

图中显示了默认工具栏及其下面的另一个工具栏,该工具栏包含带有MathWorks徽标的推工具。

通过添加一个推工具来修改默认的图形工具栏。

创建一个图形,调用数字函数。

f =图;

使用默认工具栏进行绘图。

通过查找所有类型的对象获得默认工具栏的句柄'uitoolbar'在图中。

defaultToolbar = findall (f,“类型”'uitoolbar'
defaultToolbar =带有属性的工具栏(FigureToolBar):

在默认工具栏中创建一个推送工具。创建一个16 × 16 × 3的随机RGB值数组作为它的图标。将图标添加到推工具通过设置CData属性到此阵列。

pt = uipushtool (defaultToolbar);ptImage =兰德(16日,16日,3);pt.CData = ptImage;

图中添加了自定义推送工具,作为默认工具栏中最右边的图标。

创建一个推工具来打开uisetcolor对话框时单击它。将UI图形的背景颜色更改为颜色选择器中选择的颜色。

首先,创建一个名为colorPickerPushTool.m.在程序文件中:

  • 创建一个UI图形。

  • 在UI图中创建一个工具栏。

  • 在工具栏中创建一个推工具。

  • 添加一个适当的图标到推工具通过设置图标属性值的完整文件路径paintbrush.gif

  • 为推工具创建一个提示。

  • 设置ClickedCallback属性设置为引用被调用的回调函数的函数句柄colorToolClicked

  • 创建被调用的回调函数colorToolClicked.在它中,打电话给uisetcolor函数,以便在单击工具栏中的推工具时打开颜色选择器对话框。将颜色选择器的默认颜色设置为UI图形的颜色,并指定颜色选择器的标题为'Select UI Figure Color'.将UI图形设置为当前图形,使其显示在所有其他图形之上。

函数colorPickerPushTool图= ui图形('位置',[350 500 400 300]);结核病= uitoolbar(图);pt = uipushtool(结核病);pt.Icon = fullfile (matlabroot,“工具箱”matlab的“图标”“paintbrush.gif”);pt.Tooltip =更改UI图形颜色;pt.ClickedCallback = @colorToolClicked;函数c = uisetcolor(图,事件)'Select UI Figure Color');图(图)结束结束

运行colorPickerPushTool.点击推工具打开颜色选择器。然后,选择一种颜色来更改UI图形的背景颜色。

colorPickerPushTool

在工具栏推工具中显示画笔图标的UI图形。颜色选择器对话框显示在UI图形的右侧。

输入参数

全部折叠

父工具栏,指定为工具栏对象。当创建推工具或将现有工具移动到不同的工具栏时,使用此属性指定父工具栏。

如果没有指定父工具栏,则MATLAB在当前图形的工具栏中创建一个推工具。属性创建的当前图形数字函数。如果当前图没有子工具栏,则MATLAB在当前数字中创建一个以用作父级。MATLAB不会在默认图形工具栏中创建推动工具。

如果使用数字函数不存在,则MATLAB创建一个并调用uitoolbar函数创建作为父工具栏的工具栏。

如果您向工具栏添加多个推送工具或切换工具,它们将按照创建的顺序从左向右添加。

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值是相应的价值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数name1,value1,...,namen,valuen

例子:“分隔符”,“上”将分隔线模式设置为“上”

请注意

这里列出的属性只是一个子集。有关完整列表,请参见PushTool属性

图标源或文件,指定为字符向量,字符串标量或——- - - - - -n-by-3真彩色图像数组。如果指定字符向量或字符串标量,它可以是MATLAB路径上的图像文件名或图像文件的完整路径。如果您计划与他人共享您的应用程序,请将图像文件放在MATLAB路径上,以方便应用程序打包。万博1manbetx支持的图像格式包括JPEG、PNG、GIF和SVG。

如果指定——- - - - - -n-by-3数组时,它被解释为一个真彩色图像数组。有关真彩色图像阵列的更多信息,请参见图像类型

如果指定的图像大于16 × 16像素,则图标属性将图像缩小,使整个图像适合于工具。如果指定的图像小于16 × 16像素,则不会将其放大以适应可用空间。

图标属性仅在应用程序设计器和万博1manbetx中支持uifigure的应用程序。如果图标CData属性都已设置,然后CData属性将被忽略。

例子:“程序”在MATLAB路径上指定一个图像文件。

例子:“C: \ \程序文件”指定图像文件的完整路径。

图像数组,指定为——- - - - - -n-by-3真彩色图像数组。数组中的值可以是:

  • 双精度值之间0.01.0

  • uint8之间的值0255

要防止图像显示被剪辑或扭曲,请指定数组n小于或等于16。如果图像被剪切,则只使用数组的中心16 × 16部分。

请注意

适用于App Designer和uifigure基于应用程序,使用图标属性指定推和切换工具图标。

分离线模式,指定为“关闭”或者“上”,或数字或逻辑0)或1真正的) .的值“上”相当于真正的,“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

将此属性设置为“上”在工具栏中的工具左侧绘制分割线。

提示

  • 工具栏对象(及其子对象)PushToolToggleTool对象)不出现在其WindowStyle属性设置为“模态”.如果包含工具栏子控件的图形具有WindowStyle更改为“模态”,工具栏子控件仍然存在孩子们图形的属性。但是,工具栏不会出现WindowStyle被设置为“模态”

  • 不像UICONTROL.按下按钮,按下工具不设定数字SelectionType财产“开放”在第二次点击。

另请参阅

功能

属性

之前介绍过的R2006a