Função GetSetting

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Observação : A função, método, objeto ou propriedade descrito neste tópico será desabilitada se o Microsoft Jet Expression Service está em execução no modo de área restrita, o que impede a avaliação das expressões possivelmente não seguras. Para obter mais informações sobre o modo seguro, procure por "modo seguro" na Ajuda.

Retorna um valor de configuração da chave de entrada de um aplicativo no registro do Windows ou (no Macintosh) informações no arquivo de inicialização do aplicativo.

Sintaxe

GetSetting ( appname seção, chave [padrão ] )

A sintaxe da funçãogGetSettinpossui os seguintes argumentos:

Argumento

Descrição

appname

Necessário. string expression contendo o nome do aplicativo ou projeto cuja configuração principal é solicitada. No Macintosh, este é o nome do arquivo de inicialização da pasta Preferências na pasta do sistema.

seção

Necessário. Expressão contendo o nome da seção em que a configuração da chave for encontrada de cadeia de caracteres.

chave

Necessário. Expressão contendo o nome da configuração principal para retornar de cadeia de caracteres.

padrão

Opcional. Expressão que contém o valor para retornar se nenhum valor estiver definido na configuração principal. Se omitido, defDefault será considerado uma cadeia de caracteres de comprimento zero ("").


Comentários

Se qualquer um dos itens nomeados nos argumentos GetSetting não existir, GetSetting retornará o valor padrão.

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a instrução SaveSetting primeiro para tornar as entradas no Windows registro (ou ini em plataformas do Windows de 16 bits) para o aplicativo especificado como appnamee então usa a função GetSetting para exibir uma das configurações. Como o argumento padrão é especificado, algum valor certamente ser retornado. Observe que os nomes de seção não podem ser recuperados com GetSetting. Por fim, a instrução DeleteSetting remove entradas de todos os 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"

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×