Observação: A função, método, objeto ou propriedade descrita neste tópico será desabilitada se o Serviço de Expressão de Jato da Microsoft 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 de área restrita, procure por "modo de área restrita" na Ajuda.
Retorna uma lista de configurações de chave e seus respectivos valores (originalmente criados com SaveSetting) a partir da entrada de um aplicativo no registro do Windows ou (no Macintosh) no arquivo de inicialização do aplicativo.
Sintaxe
GetAllSettings ( appname , section )
A sintaxe da função GetAllSettings tem esses argumentos:
Argumento |
Descrição |
Appname |
Obrigatório. Expressão de cadeia de caracteres que contém 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. Xpressão de cadeia de caracteres que contém o nome da seção cujas configurações de chave são solicitadas. GetAllSettings retorna uma Variant cujo conteúdo é um matriz bidimensional de cadeias de caracteres contendo todas as configurações de chave na seção especificada e seus valores correspondentes. |
Comentários
GetAllSettings retornará uma Variant não niializada se o nome do aplicativo ou a seção não existir.
Exemplo
Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). 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.
Este exemplo primeiro usa a instrução SaveSetting para fazer entradas no registro do Windows para o aplicativo especificado como nome de aplicativo 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"