Main Content

matlab.settings.reloadFactoryFile

加载或重新加载出厂设置

自 R2019b 起

说明

示例

matlab.settings.reloadFactoryFile(toolboxName) 将出厂设置树加载或重新加载到 MATLAB® 中。在检查出厂设置树之前,使用 matlab.settings.reloadFactoryFile 更新出厂设置树,而不必重新启动 MATLAB。此函数仅用于调试目的,不应包含在正式发布的工具箱代码中。

注意

  • matlab.settings.reloadFactoryFile 不重新加载 settingsInfo.json 文件。更改该文件后,您必须重新启动 MATLAB。

  • 在调用 matlab.settings.reloadFactoryFile 后,必须重新创建引用指定工具箱的任何变量。例如,如果您创建变量 a = s.mytoolbox,然后调用 matlab.settings.reloadFactoryFile,您必须重新创建 a 才能访问 mytoolbox 的更新后的设置。

示例

全部折叠

创建工具箱出厂树,然后测试树是否已正确创建。

创建函数 createMyToolboxFactoryTree,该函数为工具箱 mytoolbox 创建出厂设置树。

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

    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);
end

为工具箱创建 settingsInfo.json 文件。指定 mytoolbox 为根设置组名,createMyToolboxFactoryTree 为设置树创建函数。将 settingsInfo.json 放入工具箱 resources 文件夹中。

{
"ToolboxGroupName" : "mytoolbox",
"Hidden" : false,
"CreateTreeFcn" : "createMyToolboxFactoryTree"
}

将包含设置树创建函数和工具箱资源文件夹的文件夹添加到 MATLAB 路径。然后,加载 mytoolbox 的出厂设置树。

matlab.settings.reloadFactoryFile('mytoolbox');

使用 settings 函数访问设置树的根,并显示 FontSize 设置的值。

s = settings;
s.mytoolbox.font.FontSize
ans = 
  Setting 'mytoolbox.font.FontSize' with properties:
       ActiveValue: 11
    TemporaryValue: <no value>
     PersonalValue: <no value>
      FactoryValue: 11

输入参数

全部折叠

重新加载出厂设置的工具箱的名称,指定为字符串标量或字符向量。

示例: matlab.settings.reloadFactoryFile('mytoolbox');

版本历史记录

在 R2019b 中推出