Observação
A função, o método, o objeto ou a propriedade descrita neste tópico será desabilitada se o Serviço de Expressão do Microsoft Jet estiver em execução no modo de área restrita, o que impede a avaliação de expressões potencialmente inseguras. Para obter mais informações sobre o modo sandbox, pesquise "modo sandbox" na Ajuda.
Retorna uma lista de configurações de chave e seus respectivos valores (originalmente criados com SaveSetting) da entrada de um aplicativo no Registro do Windows ou (no Macintosh) informações no arquivo de inicialização do aplicativo.
Sintaxe
GetAllSettings(appname, section)
A sintaxe da função GetAllSettings tem estes argumentos:
| Argumento | Descrição |
|---|---|
| Nome do aplicativo | Obrigatório. Expressão de cadeia de caracteres contendo o nome do aplicativo ou projeto cujas configurações de chave são solicitadas. No Macintosh, este é o nome do arquivo de inicialização na pasta Preferências na pasta Sistema. |
| seção | Obrigatório. Expressão de cadeia de caracteres contendo o nome da seção cujas configurações de chave são solicitadas. GetAllSettings retorna uma Variant cujo conteúdo é uma matriz bidimensional de cadeias de caracteres que contém todas as configurações de chave na seção especificada e seus valores correspondentes. |
Comentários
GetAllSettings retornará uma Variant não inicializada se o nome do aplicativo ou a seção não existirem.
Exemplo
Observação
Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Esse exemplo usa primeiro a instrução SaveSetting para fazer entradas no Registro do Windows para o aplicativo especificado como appname e, em seguida, usa a função GetAllSettings para exibir as configurações. Observe que nomes de aplicativos e nomes de seção não podem ser recuperados com GetAllSettings. Por fim, a instrução DeleteSetting remove as entradas do aplicativo.
' Variant to hold 2-dimensional array returned by GetAllSettings
' Integer to hold counter.
Dim MySettings As Variant, intSettings As Integer
' Place some settings in the registry.
SaveSetting appname := "MyApp", section := "Startup", _
key := "Top", setting := 75
SaveSetting "MyApp","Startup", "Left", 50
' Retrieve the settings.
MySettings = GetAllSettings(appname := "MyApp", section := "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
Debug.Print MySettings(intSettings, 0), MySettings(intSettings, 1)
Next intSettings
DeleteSetting "MyApp", "Startup"