addSetting

Добавьте новую заводскую настройку

Описание

пример

s = addSetting(parentgroup,name) добавляет заводская настройка name заданной родительской группе фабрики и возвращает новую установку как FactorySetting. По умолчанию заводские настройки скрыты, что означает, что они не отображаются в родительской группе настроек.

пример

s = addSetting(___,Name,Value) задает свойства заводской настройки с помощью одного или нескольких аргументов пары "имя-значение". Например, 'Hidden',false создает заводскую настройку, которая отображается в дереве заводских настроек. Задайте пары "имя-значение" после всех других входных параметров.

Примеры

свернуть все

Создайте корневую группу фабрики для тулбокса mytoolbox и затем добавьте новую установку на дерево.

Создайте корневую группу фабрики mytoolbox.

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

Добавьте установку FontSize и дайте ему значение.

fontSizeSetting = addSetting(myToolboxFactoryTree,'FontSize','FactoryValue',11,'Hidden',false);

Создайте установку и задайте функцию, чтобы подтвердить ее значение.

Во-первых, создайте функцию валидации numericValidationFcn это выдает ошибку, когда вход не является числовым.

function numericValidationFcn(x)
    errorMsg = 'Value must be numeric.'; 
    assert(isnumeric(x),errorMsg);
end

Создайте корневую группу фабрики mytoolbox.

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

Добавьте установку FontSize и задайте функцию валидации numericValidationFcn.

addSetting(myToolboxFactoryTree,'FontSize','FactoryValue',11,'Hidden',false, ...
    'ValidationFcn',@numericValidationFcn);

MATLAB® выдает ошибку каждый раз, когда установка установлена в нечисловое значение.

Входные параметры

свернуть все

Родительская группа фабрики, чтобы добавить установку на в виде FactoryGroup объект. Используйте matlab.settings.FactoryGroup.createToolboxGroup функция, чтобы создать корневой групповой объект фабрики.

Пример: addSetting(s.mytoolbox,'newSetting')

Имя заводской настройки, чтобы добавить в виде вектора символов или строки. Если заводская настройка name существует в заданной родительской группе, MATLAB отображает ошибку.

Пример: addGroup(parentGroup,'newSetting')

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: addSetting(parentGroup,'newGroup','Hidden',false) создает видимую группу фабрики.

Заводское значение установки в виде данных MATLAB любого типа за исключением типов указателя. Контейнеры данных, такие как массивы ячеек, структуры и объекты, которые включают указатели, также не поддержаны. Необходимо задать или заводское значение или функцию заводского значения для установки, но не обоих.

Функция, чтобы установить заводское значение установки в виде указателя на функцию. Заводское значение установки установлено в выход заданной функции.

Указатель на функцию должен указать на функцию на пути MATLAB. Указатели анонимной или вложенной функции не поддерживаются.

Можно задать или заводское значение или функцию заводского значения для установки, но не обоих.

Скрытое состояние в виде true или false.

Когда установлено в true, заводская настройка не отображается, несмотря на то, что это остается доступным.

Состояние только для чтения в виде true или false. Когда true, личностная или временная ценность установки не может быть задана.

Функция, чтобы подтвердить установку в виде указателя на функцию. Когда задано, функция используется, чтобы подтвердить значение заводской настройки.

Указатель на функцию должен быть сопоставлен с функцией, которая принимает потенциальное устанавливающее значение как входной параметр, не имеет никаких выходных аргументов и выдает ошибку, если валидация перестала работать.

Указатель на функцию должен указать на функцию на пути MATLAB. Указатели анонимной или вложенной функции не поддерживаются.

Введенный в R2019b
Для просмотра документации необходимо авторизоваться на сайте