FactoryGroup

出厂设置和出厂子组对象的组

自 R2019b 起

说明

FactoryGroup 是出厂设置树内的一个对象。树的顶部是根 FactoryGroup。每个 FactoryGroup 可以包含其他 FactoryGroup 和 FactorySetting 对象的集合。有关创建出厂设置树的详细信息，请参阅Create Factory Settings for Toolboxes。

创建对象

使用 matlab.settings.FactoryGroup.createToolboxGroup 函数创建 FactoryGroup 根对象。例如：

myToolboxSettings = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox','Hidden',false);

属性

全部展开

`Name` — 出厂组的名称
字符向量 | 字符串

出厂组的名称，指定为字符向量或字符串。

`Hidden` — 隐藏状态
`true` (默认) | `false`

隐藏状态，指定为 true 或 false。

当设置为 true 时，出厂组（包括组中的所有出厂组和出厂设置）不会显示在命令行窗口中或作为 Tab 键自动填充的一部分，但仍可访问它们。

`ValidationFcn` — 用于验证出厂组中的设置的函数
函数句柄

用于验证组内出厂设置的函数，指定为函数句柄。如果指定，该函数将用于验证组内未指定其自有验证函数的所有出厂设置的值，但指定其自有验证函数的设置除外。其中包括子组中的设置，前提是子组或设置未指定它们自己的验证函数。

对象函数

`addGroup`	添加新的出厂设置组
`addSetting`	添加新出厂设置
`matlab.settings.FactoryGroup.createToolboxGroup`	为工具箱创建 `FactoryGroup` 根对象

示例

全部折叠

创建工具箱出厂树

为工具箱 mytoolbox 创建出厂设置树。

创建根出厂组 mytoolbox。

myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox', ...
    'Hidden',false);

将 font 组添加到树中，并添加字体大小和字体颜色两个设置。

toolboxFontGroup = addGroup(myToolboxFactoryTree,'font','Hidden',false);
addSetting(toolboxFontGroup,'FontSize','FactoryValue',11,'Hidden',false, ...
    'ValidationFcn',@matlab.settings.mustBeNumericScalar);
addSetting(toolboxFontGroup,'FontColor','FactoryValue','Black', ...
    'Hidden',false,'ValidationFcn',@matlab.settings.mustBeStringScalar);