主要内容

addSetting

添加新的出厂设置

自从R2019b

折叠所有页面

语法

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

描述

例子

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

例子

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

例子

全部折叠

为工具箱创建根工厂组mytoolbox然后在树中添加一个新的设置。

创建根工厂组mytoolbox．

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

添加设置字形大小并给它一个默认值。

(myToolboxFactoryTree，“字形大小”，“FactoryValue”11“隐藏”、假);

创建一个设置并指定一个函数来验证它的值。

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

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

创建根工厂组mytoolbox．

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

添加设置字形大小并指定验证函数numericValidationFcn．MATLAB®每当将设置设置为非数字值时，抛出错误。

addSetting (myToolboxFactoryTree“字形大小”，“FactoryValue”11“隐藏”假的,.．.“ValidationFcn”, @numericValidationFcn);

输入参数

全部折叠

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

例子:addSetting (s.mytoolbox newSetting)

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

例子:addGroup (parentGroup newSetting)

名称-值参数

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

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

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

出厂设置值，指定为除句柄类型外的任何类型的MATLAB数据。数据容器(例如单元格数组、结构和包含句柄的对象)也不受支持。金宝app您必须为该设置指定一个出厂值或出厂值函数，但不能同时指定两者。

函数来设置作为函数句柄指定的设置出厂值。设置的出厂值被设置为指定函数的输出。

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

您可以为该设置指定一个出厂值或出厂值函数，但不能同时指定两者。

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

当设置为真正的，出厂设置不会显示在命令窗口或作为制表符补全的一部分，尽管它仍然是可访问的。

只读状态，指定为真正的或假．当真正的，则无法设置设置的个人值或临时值。

函数来验证作为函数句柄指定的设置值。指定后，该函数验证出厂设置的值。

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

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

版本历史

R2019b引入

另请参阅

|

主题