`addGroup`

Cria um novo grupo de configurações na árvore de configurações ou dentro de outro grupo.

Categoria: Environment and Settings > System Commands

Sintaxe

G = addGroup(parent, name)

Adiciona um grupo chamado name em parent e o retorna.

G = addGroup(parent, name, 'Hidden', tf)

Também marca o grupo como oculto quando tf é verdadeiro.

Descrição

A árvore de configurações guarda valores em grupos nomeados. Grupos de produtos como matlab já existem; um programa ou toolbox cria o seu próprio grupo para manter as opções em um só lugar. Grupos podem ser aninhados e são acessados com a sintaxe de ponto: s.mygroup.sub.

Criar um grupo cujo nome já existe no mesmo pai é um erro. Use hasGroup para verificar antes e removeGroup para apagá-lo.

Argumentos de entrada

parent: O objeto raiz retornado por settings, ou um SettingsGroup existente.
name: Nome do grupo. Deve começar com letra e conter apenas letras, dígitos e sublinhados.

Argumentos de saída

G: O novo objeto matlab.settings.SettingsGroup.

Exemplo

Criar e remover um grupo

s = settings;
g = addGroup(s, 'demo');
disp(class(g))
disp(hasGroup(s, 'demo'))
removeGroup(s, 'demo');
disp(hasGroup(s, 'demo'))

Saída

matlab.settings.SettingsGroup
   1
   0

Observações

No MatLivre, os valores pessoais valem apenas para a sessão atual; não são gravados entre execuções como o MATLAB faz.

Veja também

settings hasGroup removeGroup addSetting