主要内容

addGroup

添加新的出厂设置组

折叠所有页面

语法

s = addGroup(parentgroup,name)
s = addGroup(___、名称、值)

描述

例子

s = addGroup(parentgroup，的名字）添加出厂设置组的名字返回指定的父出厂设置组，并将新组返回为FactoryGroup对象。默认情况下，出厂设置组是隐藏的，这意味着它们不会显示在父设置组中。

例子

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

例子

全部折叠

为工具箱创建根工厂组mytoolbox然后向树中添加一个组。

创建根工厂组mytoolbox．

myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup(“mytoolbox”，.．.“隐藏”、假);

添加字体分组到树。

toolboxFontGroup = addGroup(myToolboxFactoryTree，“字体”，“隐藏”、假);

添加设置组并指定默认验证函数。此函数验证组内所有设置的值，指定自己的验证函数的设置除外。这包括子组中的设置，只要子组或设置没有指定它们自己的验证函数。

首先，创建一个验证函数numericValidationFcn它在输入不是数字时抛出错误。

函数numericValidationFcn(x) errorMsg =“值必须是数字。”；断言(isnumeric (x), errorMsg);结束

创建根工厂组mytoolbox然后添加组mynumericsettings到树上去。指定验证函数numericValidationFcn．MATLAB®每当将组中的设置设置为非数字值时，抛出错误。

myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup(“mytoolbox”，.．.“隐藏”、假);toolboxFontGroup = addGroup(myToolboxFactoryTree，“mynumericsettings”，“隐藏”假的,.．.“ValidationFcn”, @numericValidationFcn);

输入参数

全部折叠

要将组添加到的父工厂组，指定为FactoryGroup对象。使用matlab.settings.FactoryGroup.createToolboxGroup函数创建根工厂组对象。

例子:addGroup (s.mytoolbox newGroup)

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

例子:addGroup (s.mytoolbox newGroup)

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:addGroup (parentGroup‘newGroup’,‘隐藏’,假)创建一个可见工厂组。

隐藏状态，指定为真正的或假．

当设置为真正的，工厂组，包括组中的所有工厂组和工厂设置，不会显示在命令窗口中或作为制表符补全的一部分，尽管它们仍然是可访问的。

函数验证组中的出厂设置，指定为函数句柄。指定后，该函数验证组内所有出厂设置的值，但指定自己的验证函数的设置除外。这包括子组中的设置，只要子组或设置没有指定它们自己的验证函数。

函数句柄必须与一个函数相关联，该函数接受潜在的设置值作为输入参数，没有输出参数，并且在验证失败时抛出错误。

函数句柄必须指向MATLAB路径上的函数。不支持匿名或嵌套函数句柄。金宝app

版本历史

R2019b引入

另请参阅

|

主题