主要内容

ReleaseCompatibilityResults

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

描述

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

创建

创建一个ReleaseCompatibilityResults对象获取特定的工具箱版本号matlab.settings.loadSettingsCompatibilityResults函数。例如,该命令获取ReleaseCompatibilityResults用于版本的对象2工具箱的一部分mytoolbox

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

ans = ReleaseCompatibilityResults with properties: VersionLabel: "Version2" PreValidationExceptions: [0×0 matlab.settings. settings.]release asecompatibilityexception] Results: [1×1 matlab.settings.VersionResults]

属性

全部展开

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

例子:“Version2”

第一个预验证异常,指定为ReleaseCompatibilityException对象。PreValidationExceptions是在升级个人设置之前验证个人设置树和出厂设置树时发生的第一个异常。如果没有异常,PreValidationExceptions是一个0乘0的数组ReleaseCompatibilityException对象。

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

例子

全部折叠

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

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

函数myToolboxFactoryTree = creatatemytoolboxfactorytree ()“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对象。

函数upgraders = createMyToolboxSettingsFileUpgraders() upgraders = matlab.settings. settingsfileupgraders .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;

中的设置名称createMyToolboxFactoryTreeMyFontSize而且MyFontColor字形大小而且FontColor

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

中记录两个设置的重命名createMyToolboxSettingsFileUpgraders功能作为版本的设置树的更改2mytoolbox

函数upgraders = createytoolboxsettingsfileupgraders () upgraders = 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

获取版本的升级结果2mytoolbox

matlab.settings.loadSettingsCompatibilityResults (“mytoolbox”“Version2”
ans = ReleaseCompatibilityResults with properties: VersionLabel: "Version2" PreValidationExceptions: [0×0 matlab.settings. settings.]release asecompatibilityexception] Results: [1×1 matlab.settings.VersionResults]

版本历史

R2019b引入