ReleaseCompatibilityResults

工具箱与特定的版本号升级的结果

自从R2019b

描述

一个ReleaseCompatibilityResults对象表示的结果升级工具箱的个人设置为一个特定的版本号。

创建

创建一个ReleaseCompatibilityResults对象通过使用特定的工具箱版本号matlab.settings.loadSettingsCompatibilityResults函数。例如,这个命令得到ReleaseCompatibilityResults对象的版本2的工具箱mytoolbox。

myCompatibilityResults = matlab.settings.loadSettingsCompatibilityResults (“mytoolbox”,“Version2”)

ans = ReleaseCompatibilityResults属性:VersionLabel:“Version2”PreValidationExceptions: [0×0 matlab.settings。ReleaseCompatibilityException)结果:[1×1 matlab.settings.VersionResults]

属性

全部展开

`VersionLabel`- - - - - -版本升级到工具箱
字符串标量

版本升级到工具箱,指定为一个字符串标量。

例子:“Version2”

`PreValidationExceptions`- - - - - -第一个prevalidation例外
`ReleaseCompatibilityException`对象|0-by-0的数组`ReleaseCompatibilityException`对象

第一个prevalidation例外,指定为一个ReleaseCompatibilityException对象。PreValidationExceptions是第一个在验证个人和工厂发生异常设置树升级前的个人设置。如果没有异常出现,PreValidationExceptions是一系列0-by-0的ReleaseCompatibilityException对象。

`结果`- - - - - -升级结果
的数组`VersionResults`对象

升级的结果,指定为数组VersionResults对象。

例子

全部折叠

得到升级的个人设置的结果

创建函数来创建工具箱工厂升级树然后测试升级成功完成。

这个函数createMyToolboxFactoryTree为工具箱创建树的工厂设置mytoolbox。

函数myToolboxFactoryTree = createMyToolboxFactoryTree () myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup (“mytoolbox”,…“隐藏”、假);toolboxFontGroup = addGroup (myToolboxFactoryTree,“字体”,“隐藏”假)addSetting (toolboxFontGroup“MyFontSize”,“FactoryValue”11“隐藏”假的,…“ValidationFcn”@matlab.settings.mustBeNumericScalar) addSetting (toolboxFontGroup“MyFontColor”,“FactoryValue”,“黑”,…“隐藏”假的,“ValidationFcn”,@matlab.settings.mustBeStringScalar);结束

创建函数createMyToolboxSettingsFileUpgraders空着matlab.settings.SettingsFileUpgrader对象。

函数升级升级= createMyToolboxSettingsFileUpgraders () = matlab.settings.SettingsFileUpgrader.empty;结束

创建settingsInfo.json文件的工具。指定mytoolbox作为根设置组名,createMyToolboxFactoryTree设置树创建功能,createMyToolboxSettingsFileUpgraders设置树升级功能。的地方settingsInfo.json在工具箱中资源文件夹中。

{“ToolboxGroupName”:“mytoolbox”,“隐藏”:假的,“CreateTreeFcn”:“createMyToolboxFactoryTree”,“CreateUpgradersFcn”:“createMyToolboxSettingsFileUpgraders”}

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

matlab.settings.reloadFactoryFile (“mytoolbox”);

使用设置函数来访问设置树的根和设置的个人价值MyFontSize设置。

s =设置;s.mytoolbox.font.MyFontSize。PersonalValue = 15;

更改设置名称createMyToolboxFactoryTree从MyFontSize和MyFontColor来字形大小和FontColor。

函数myToolboxFactoryTree = createMyToolboxFactoryTree () myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup (“mytoolbox”,…“隐藏”、假);toolboxFontGroup = addGroup (myToolboxFactoryTree,“字体”,“隐藏”假)addSetting (toolboxFontGroup“字形大小”,“FactoryValue”11“隐藏”假的,…“ValidationFcn”@matlab.settings.mustBeNumericScalar) addSetting (toolboxFontGroup“FontColor”,“FactoryValue”,“黑”,…“隐藏”假的,“ValidationFcn”,@matlab.settings.mustBeStringScalar);结束

记录两个设置的重命名createMyToolboxSettingsFileUpgraders函数作为版本更改设置树2的mytoolbox。

函数升级升级= createMyToolboxSettingsFileUpgraders () = matlab.settings.SettingsFileUpgrader (“Version2”);移动(升级,“mytoolbox.font.MyFontSize”,“mytoolbox.font.FontSize”);移动(升级,“mytoolbox.font.MyFontColor”,“mytoolbox.font.FontColor”);结束

重新加载树的工厂设置mytoolbox。

matlab.settings.reloadFactoryFile (“mytoolbox”);

使用设置函数来访问设置树的根和确认的个人价值字形大小设置是正确的MyFontSize设置。

s =设置;s.mytoolbox.font.FontSize

ans mytoolbox.font =设置”。字形大小' with properties: ActiveValue: 15 TemporaryValue:  PersonalValue: 15 FactoryValue: 11

获得版本升级的结果2的mytoolbox。

matlab.settings.loadSettingsCompatibilityResults (“mytoolbox”,“Version2”)

ans = ReleaseCompatibilityResults属性:VersionLabel:“Version2”PreValidationExceptions: [0×0 matlab.settings。ReleaseCompatibilityException)结果:[1×1 matlab.settings.VersionResults]