Função GetAllSettings

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 uma lista das principais configurações 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 seção )

A sintaxe da função GetAllSettings possui os seguintes argumentos:

Argumento

Descrição

appname

Necessário. Expressão contendo o nome do aplicativo ou projeto cujas configurações principais são solicitadas de cadeia de caracteres. No Macintosh, este é o nome do arquivo de inicialização da pasta Preferências na pasta do sistema.

seção

Necessário. Cadeia de caracteres expression contendo o nome da seção cujas configurações principais são solicitadas. GetAllSettings retorna uma variante cujo conteúdo é uma bidimensional matriz de cadeias de caracteres que contém todas as configurações principais da seção especificada e seus valores correspondentes.


Comentários

GetAllSettings retorna um não inicializados Variant se appname ou seção não existe.

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 para tornar as entradas no registro do Windows para o aplicativo especificado como appnameprimeiro, depois usa a função GetAllSettings para exibir as configurações. Observe que os nomes de aplicativo e nomes de seção não podem ser recuperados com GetAllSettings. Por fim, a instrução DeleteSetting remove 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"

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.

×