Exponenta Banner
exponenta event banner

addGroup

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

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

Синтаксис

s = addGroup (родительская группа, имя)
s = 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, заводская группа, включая все заводские группы и заводские настройки внутри группы, не отображается в окне команд или в процессе заполнения вкладки, хотя они остаются доступными.

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

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

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

См. также

|

Темы

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

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

Поддержка