addGroup

Добавьте новую группу заводских настроек

Описание

пример

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

пример

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

Примеры

свернуть все

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

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

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

Добавьте font группа к дереву.

toolboxFontGroup = addGroup(myToolboxFactoryTree,'font','Hidden',false);

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

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

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

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

myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox', ...
    'Hidden',false);
toolboxFontGroup = addGroup(myToolboxFactoryTree,'mynumericsettings','Hidden',false, ...
    'ValidationFcn',@numericValidationFcn);

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

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

свернуть все

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

Пример: addGroup(s.mytoolbox,'newGroup')

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

Пример: addGroup(s.mytoolbox,'newGroup')

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

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

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

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

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

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

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

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

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