主要内容

addGroup

添加新的工厂设置组

描述

例子

s = addGroup(ParentGroup,,,,姓名添加工厂设置组姓名到指定的父厂设置组,并将新组返回FactoryGroup目的。默认情况下,出厂设置组是隐藏的,这意味着它们不会在父设置组中显示。

例子

s = addGroup(___,,,,名称,价值使用一个或多个名称值对参数指定出厂组属性。例如,“隐藏”,错误在工厂设置树中添加了一个可见的组。在所有其他输入参数之后,指定名称值对。

例子

全部收缩

为工具箱创建根工厂组mytoolbox然后在树上添加一组。

创建根工厂组mytoolbox

myToolboxFactoryTree = matlab.settings.factorygroup.createtoolboxgroup('myToolbox',,,,...'隐',错误的);

添加字体分组到树上。

ToolboxFontGroup = AddGroup(MyToolboxFactoryTree,“字体”,,,,'隐',错误的);

添加设置组并指定默认验证功能。此功能验证了组内所有设置的值,除了指定自己的验证功能的设置外。只要子组或设置未指定自己的验证功能,这包括子组中的设置。

首先,创建验证功能数字validationfcn当输入不是数字时,这会引发错误。

功能numericValidationFcn(x)errormsg =“价值必须是数字。”;断言(isnumeric(x),errormsg);结尾

创建根工厂组mytoolbox然后添加组mynumericsettings到树。指定验证功能数字validationfcn。MATLAB®每当组中的设置设置为非数值值时,就会引发错误。

myToolboxFactoryTree = matlab.settings.factorygroup.createtoolboxgroup('myToolbox',,,,...'隐',错误的);ToolboxFontGroup = AddGroup(MyToolboxFactoryTree,“ mynumericsettings”,,,,'隐',错误的,...'验证FCN',@numericValidationFcn);

输入参数

全部收缩

亲本工厂组将组添加到,指定为FactoryGroup目的。使用matlab.settings.factorygroup.createtoolboxgroup函数以创建根工厂组对象。

例子:AddGroup(S.MyToolbox,'newGroup')

要添加的工厂组的名称,指定为字符向量或字符串。如果工厂小组姓名MATLAB已经存在于指定的父厂组中,显示错误。

例子:AddGroup(S.MyToolbox,'newGroup')

名称值参数

指定可选的逗号分隔对名称,价值参数。姓名是参数名称和价值是相应的值。姓名必须出现在引号中。您可以按任何顺序指定几个名称和值对参数NAME1,Value1,...,Namen,Valuen

例子:addGroup(parentgroup,'newgroup',“ hidden”,false)创建一个可见的工厂组。

隐藏状态,指定为真的或者错误的

设置为真的,工厂组,包括该组中的所有工厂组和工厂设置,在命令窗口中不显示或作为选项卡完成的一部分显示,尽管它们仍然可以访问。

函数以验证一个组中的工厂设置,该设置指定为函数句柄。指定时,该函数验证了组内所有出厂设置的值,除了指定自己的验证功能的设置外。只要子组或设置未指定自己的验证功能,这包括子组中的设置。

函数句柄必须与接受潜在设置值作为输入参数,没有输出参数的函数关联,如果验证失败,则会引发错误。

该功能手柄必须指向MATLAB路径上的函数。不支持匿名或嵌套功能手柄。万博1manbetx

在R2019b中引入