主要内容

VersionResults

升级操作结果

描述

一个VersionResults对象包含升级工具箱的个人设置时每个操作的结果。

创建

创建一个ReleaseCompatibilityResults对象获取特定的工具箱版本号matlab.settings.loadSettingsCompatibilityResults函数。然后,访问结果属性来获取VersionResults对象。

例如,此代码获取VersionResults用于版本的对象2工具箱的一部分mytoolbox

myCompatibilityResults = matlab.settings.loadSettingsCompatibilityResults(“mytoolbox”“Version2”);myCompatibilityResults。结果
ans = VersionResults with properties: VersionLabel: "Version2" VersionChanges: [1×2 matlab.settings.OperationResult]

属性

全部展开

结果的工具箱版本,指定为字符串标量。

例子:“Version2”

每个升级操作的状态,指定为操作结果对象数组。

例子

全部折叠

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

这个函数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. loadsettings相容结果(“mytoolbox”“Version2”);compatibilityResults。结果
ans = VersionResults with properties: VersionLabel: "Version2" VersionChanges: [1×2 matlab.settings.OperationResult]

版本历史

R2019b引入