主要内容

uitoggletool.

在工具栏中创建切换工具

描述

tt= uitoggletool在当前图形的工具栏中创建切换工具,并返回Toggletool.目的。

目前的数字必须是一个创建的数字数字函数。如果当前的图形没有子工具栏,那么matlab®在当前数字中创建一个以作为父级。如果使用数字函数不存在,则MATLAB创建一个并调用uitoolbar函数创建一个工具栏作为父工具栏。

切换工具有两个状态:'离开'或者“上”.每次单击它时按钮的状态会更改。

例子

tt= uitoggletool (在指定的父工具栏中创建一个切换工具。

例子

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

例子

全部收缩

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

f =图;tb = uitoolbar(f);

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

在工具栏中创建一个切换工具。创建一个16 × 16 × 3的零数组作为它的图标。设置cdata.属性值以在切换工具中显示黑色正方形图标。

tt = uitoggletool(结核病);ttImage = 0(3) 16日16日;tt。CData = ttImage;

显示默认工具栏及其下面的自定义工具栏的图。自定义工具栏显示一个黑色方块作为切换工具。

创建一个切换工具,可以在每次单击它时更改其图标和UI图的背景颜色。

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

  • 创建一个UI图形。

  • 在UI图中创建工具栏。

  • 向工具栏添加切换工具。

  • 创建蓝色TrueColor映像数组。设置切换工具图标属性价值。

  • 设置点击allback.函数处理的属性引用调用回调函数toggleFigureColor

  • 创建被调用的回调函数toggleFigureColor.在它中,查询值的值状态切换工具的属性。如果国家是“上”,将图形的背景色改为蓝色,并将切换工具改为黑色。同样,如果状态为'离开',然后将图形背景颜色改为黑色,并将make the toggle工具改为蓝色。

功能togglecolor无花果= Uifigure;tb = uitoolbar(图);tt = uitoggletool(结核病);ttImage = 0(3) 16日16日;TTIMAGE(:,:,3)= =(16);tt.icon = ttimage;tt.clickedCallback = @ToggleFigureColor;功能toggleFigureColor(src,event) state = src. state;如果比较字符串(状态,“上”) fig.Color ='蓝色';tt。图标= 0(3)16日16日;其他的图.Color =.“黑”;tt.icon = ttimage;结束结束结束

运行togglecolor..点击切换工具可以改变图形的背景颜色。

togglecolor.
使用蓝色方形图标显示工具栏和一个切换工具的UI图。

输入参数

全部收缩

父工具栏,指定为工具栏目的。使用此属性在创建切换工具或将现有工具移动到其他工具栏时指定父工具栏。

如果未指定父工具栏,则MATLAB在当前图形的工具栏中创建一个切换工具。目前的数字必须是一个创建的数字数字函数。如果当前图形没有子工具栏,则MATLAB在当前图形中创建一个作为父工具栏。MATLAB没有在默认图形工具栏中创建切换工具。

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

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

名称-值参数

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

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

请注意

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

切换按钮状态,指定为'离开'或者“上”,或数字或逻辑0)或1真的)。价值“上”相当于真的, 和'离开'相当于.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnoffSwitchState.

当此属性值为“上”时,切换按钮出现在向下(按下)位置。当此属性值为'离开',Toggle按钮出现在UP位置。改变国家导致适当的OnCallback或者OffCallback函数执行。

图标源或文件,指定为字符矢量,字符串标量或-经过-n-by-3真彩色图像数组。如果指定字符向量或字符串标量,则可以是MATLAB路径上的图像文件名或图像文件的完整路径。如果打算与其他人分享您的应用程序,请将Matlab路径上的图像文件放在vallab路径上以促进应用程序包装。万博1manbetx支持的图像格式包括JPEG,PNG,GIF和SVG。

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

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

图标属性仅在App Desi万博1manbetxgner和App Designer和uifigure的应用程序。如果图标cdata.属性都设定,那么cdata.属性将被忽略。

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

例子:'c:\ documents \ icon.png'指定图像文件的完整路径。

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

  • 双精度值之间0.01.0

  • uint8价值0255

要防止图像出现剪裁或扭曲,请指定阵列n小于或等于16.如果图像被剪切,则仅使用阵列的中心16×16部分。

请注意

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

提示

  • 工具栏对象(和他们的孩子PushToolToggletool.对象)不出现在其windowstyle.属性设置为'模态'.如果包含工具栏子控件的图形具有windowstyle.变成'模态',工具栏子控件仍然存在孩子们图的财产。但是,工具栏不会出现windowstyle.被设定为'模态'

另请参阅

功能

属性

在R2006A之前介绍