Main Content

FactorySetting

出厂设置对象

自 R2019b 起

说明

FactorySetting 对象表示出厂设置树内的单个设置。

创建对象

使用 addSetting 函数在 FactoryGroup 根对象中创建 FactorySetting 对象。例如:

myToolboxSettings = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox','Hidden',false);
myFactorySetting = addSetting(myToolboxSettings,'MySetting','Hidden',false,'FactoryValue',10);

属性

全部展开

出厂设置的名称,指定为字符向量或字符串。

隐藏状态,指定为 truefalse

当设置为 true 时,出厂设置不会显示在命令行窗口中或作为 Tab 键自动填充的一部分,但仍可访问它们。

只读状态,指定为 truefalse。在为 true 时,无法指定设置的个人值或临时值。

出厂设置的值,指定为除句柄类型外的任何类型的 MATLAB 数据。也不支持包含句柄的数据容器,如元胞数组、结构体和对象。必须为设置指定出厂值或出厂值函数,但不能同时指定两者。

用于设定出厂设置值的函数,指定为函数句柄。出厂设置的值设置为指定函数的输出。

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

可以为设置指定出厂值或出厂值函数,但不能同时指定两者。

用于验证设置值的函数,指定为函数句柄。如果指定了该函数,它将用于验证出厂设置的值。

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

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

示例

全部折叠

为工具箱 mytoolbox 创建根出厂组,然后将一个新设置添加到树中。

创建根出厂组 mytoolbox

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

添加 FontSize 设置并将其赋值为默认值。MATLAB 会将新的设置作为 FactorySetting 对象返回。

fontSizeSetting = addSetting(myToolboxFactoryTree,'FontSize','FactoryValue',11,'Hidden',false);

版本历史记录

在 R2019b 中推出