Função GetSetting
Retorna um valor de configuração de chave da entrada de um aplicativo no registro do Windows ou (no Macintosh) no arquivo de inicialização do aplicativo.
Sintaxe
GetSetting(appname, section, key, [ default ])
A sintaxe da função GetSetting tem esses argumentos nomeados:
| Sair | Descrição |
|---|---|
| appname | Obrigatório. Expressão de cadeia de caracteres que contém o nome do aplicativo ou projeto cuja configuração de chave é solicitada. No Macintosh, este é o nome do arquivo de inicialização na pasta Preferências na pasta Sistema. |
| section | Obrigatório. Expressão de cadeia de caracteres que contém o nome da seção em que a configuração da chave é encontrada. |
| key | Obrigatório. Expressão de cadeia de caracteres que contém o nome da configuração de chave a ser retornada. |
| default | Opcional. Expressão que contém o valor a ser retornado se nenhum valor for definido na configuração da chave. Se omitido, o padrão será considerado uma cadeia de caracteres de comprimento zero (""). |
Comentários
Se algum dos itens nomeados nos argumentos GetSetting não existir, GetSetting retornará o valor do padrão.
Exemplo
Este exemplo primeiro usa a instrução SaveSetting para fazer entradas no registro do Windows (ou .ini arquivo em plataformas windows de 16 bits) para o aplicativo especificado como nome de aplicativo e, em seguida, usa a função GetSetting para exibir uma das configurações. Como o argumento padrão é especificado, algum valor é garantido para ser retornado. Observe que os nomes de seção não podem ser recuperados com GetSetting. Por fim, a instrução DeleteSetting remove todas as entradas do aplicativo.
' Variant to hold 2-dimensional array returned by GetSetting.
Dim MySettings As Variant
' Place some settings in the registry.
SaveSetting "MyApp","Startup", "Top", 75
SaveSetting "MyApp","Startup", "Left", 50
Debug.Print GetSetting(appname := "MyApp", section := "Startup", _
key := "Left", default := "25")
DeleteSetting "MyApp", "Startup"
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.