Exponenta Banner
exponenta event banner

ReleaseCompatibilityResults

Результаты обновления набора инструментов с определенным номером версии

развернуть все на странице

Описание

A 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.ReleaseCompatibilityException]
                    Results: [1×1 matlab.settings.VersionResults]

Свойства

развернуть все

Панель инструментов версии обновляется до, указывается как строковый скаляр.

Пример: 'Version2'

Первое исключение преобладания, указанное как ReleaseCompatibilityException объект. PreValidationExceptions является первым исключением, которое возникает при проверке дерева личных и заводских параметров перед обновлением личных параметров. Если исключения не возникает, PreValidationExceptions является массивом 0-by-0 ReleaseCompatibilityException объекты.

Результаты обновления, указанные как массив VersionResults объекты.

Примеры

свернуть все

Создайте функции для создания, а затем обновите дерево фабрики панели инструментов, а затем проверьте, успешно ли завершено обновление.

Функция createMyToolboxFactoryTree создает дерево заводских настроек для панели инструментов mytoolbox.

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

    toolboxFontGroup = addGroup(myToolboxFactoryTree,'font','Hidden',false)
    addSetting(toolboxFontGroup,'MyFontSize','FactoryValue',11,'Hidden',false, ...
        'ValidationFcn',@matlab.settings.mustBeNumericScalar)    
    addSetting(toolboxFontGroup,'MyFontColor','FactoryValue','Black', ...
        'Hidden',false,'ValidationFcn',@matlab.settings.mustBeStringScalar);
end

Создание функции createMyToolboxSettingsFileUpgraders с пустым matlab.settings.SettingsFileUpgrader объект.

function upgraders = createMyToolboxSettingsFileUpgraders()
    upgraders = matlab.settings.SettingsFileUpgrader.empty;
end

Создать settingsInfo.json для панели инструментов. Определить mytoolbox в качестве имени корневой группы настроек, createMyToolboxFactoryTree в качестве функции создания дерева настроек и createMyToolboxSettingsFileUpgraders в качестве функции обновления дерева настроек. Место settingsInfo.json на панели инструментов resources папка.

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

Добавьте папку, содержащую функцию создания дерева настроек и папку ресурсов панели инструментов, в путь MATLAB ®. Затем загрузите дерево заводских настроек дляmytoolbox.

matlab.settings.reloadFactoryFile('mytoolbox');

Используйте settings для доступа к корню дерева настроек и установки персонального значения MyFontSize установка.

s = settings;
s.mytoolbox.font.MyFontSize.PersonalValue = 15;

Изменение имен параметров в createMyToolboxFactoryTree от MyFontSize и MyFontColor кому FontSize и FontColor.

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

Запишите переименование двух параметров в createMyToolboxSettingsFileUpgraders функция как изменения дерева настроек для версии 2 из mytoolbox.

function upgraders = createMyToolboxSettingsFileUpgraders()
    upgraders = matlab.settings.SettingsFileUpgrader('Version2'); 
    move(upgraders,'mytoolbox.font.MyFontSize','mytoolbox.font.FontSize'); 
    move(upgraders,'mytoolbox.font.MyFontColor','mytoolbox.font.FontColor');
end

Перезагрузите дерево заводских настроек для mytoolbox.

matlab.settings.reloadFactoryFile('mytoolbox');

Используйте settings для доступа к корню дерева настроек и проверки персонального значения FontSize параметр был правильно перемещен из MyFontSize установка.

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

Получение результатов обновления для версии 2 из mytoolbox.

matlab.settings.loadSettingsCompatibilityResults('mytoolbox','Version2')
ans = 
  ReleaseCompatibilityResults with properties:
               VersionLabel: "Version2"
    PreValidationExceptions: [0×0 matlab.settings.ReleaseCompatibilityException]
                    Results: [1×1 matlab.settings.VersionResults]

См. также

| |

Темы

Представлен в R2019b

Документация MATLAB

Поддержка