OperationResult

状态时的个人操作升级工具

描述

一个OperationResult对象表示单个操作的状态,当升级的个人设置工具箱。

创建

创建一个ReleaseCompatibilityResults对象通过使用特定的工具箱版本号matlab.settings.loadSettingsCompatibilityResults函数。的结果财产的ReleaseCompatibilityResults对象包含一个VersionResults对象。的VersionChanges的属性,VersionResults对象包含的数组OperationResult对象。

例如,这个代码得到的数组OperationResult对象的版本2的工具箱mytoolbox。

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

ans = 1×2 OperationResult数组属性:ExceptionLog操作状态

属性

全部展开

`操作`- - - - - -执行升级操作
字符串标量

执行升级操作,指定为字符串标量。

例子:“mytoolbox.font移动。MyFontSizemytoolbox。font.FontSize"

`状态`- - - - - -升级操作的状态
`“成功”`|`“跳过”`|`“失败”`

状态升级操作,指定为“成功”,“跳过”,或“失败”。此表描述了每个状态和可能的原因。

状态	导致
`“成功”`	N /一个
`“跳过”`	设置或设置组中指定操作不存在个人设置的升级。
`“失败”`	移动操作	升级设置树已经包含设置与指定名称或组。设置或设置组指定路径不是一个有效的路径。
`“失败”`	删除操作	设置或设置组指定路径不是一个有效的路径。

`ExceptionLog`- - - - - -第一次升级异常
`ReleaseCompatibilityException`对象|0-by-0的数组`ReleaseCompatibilityException`对象

第一次升级的异常发生在执行升级操作,指定为一个ReleaseCompatibilityException对象。如果没有异常出现,ExceptionLog是一系列0-by-0的ReleaseCompatibilityException对象。

例子

全部折叠

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

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

这个函数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。

compatibilityResults.matlab.settings.loadSettingsCompatibilityResults (“mytoolbox”,“Version2”);compatibilityResults.Results.VersionChanges (1)

ans = OperationResult属性:操作:“mytoolbox.font移动。MyFontSize mytoolbox.font.FontSize”状态:“成功”ExceptionLog:[0×0 matlab.settings.ReleaseCompatibilityException]