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. MATLAB® выдает ошибку каждый раз, когда для параметра в группе задано нечисловое значение.

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

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

свернуть все

Родительская заводская группа, в которую нужно добавить группу, заданная как 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заводская группа, включая все заводские группы и заводские настройки в группе, не отображается в Командном окне или как часть заполнения клавишей Tab, хотя они остаются доступными.

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

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

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

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