Applies ToAccess para Microsoft 365 Access 2021 Access 2019 Access 2016

Nota: A função, método, objeto ou propriedade descrita neste tópico está desativada se o Serviço Microsoft Jet Expression estiver em execução no modo sandbox, o que impede a avaliação de expressões potencialmente inseguras. Para obter mais informações sobre o modo sandbox, procure "modo sandbox" na Ajuda.

Devolve um valor de definição de chave a partir da entrada de uma aplicação no registo do Windows ou (no Macintosh) informações no ficheiro de inicialização da aplicação.

Sintaxe

GetSetting ( appname , section, key [, default ] )

A sintaxe da função g GetSettin tem estes argumentos:

Argumento

Descrição

nome da aplicação

Obrigatório. expressão de cadeia que contém o nome da aplicação ou projeto cuja definição de chave é pedida. No Macintosh, este é o nome de ficheiro do ficheiro de inicialização na pasta Preferências na pasta Sistema.

secção

Obrigatório. Expressão de cadeia que contém o nome da secção onde a definição de chave é encontrada.

tecla

Obrigatório. Expressão de cadeia que contém o nome da definição de chave a devolver.

predefinição

Opcional. Expressão que contém o valor a devolver se não for definido nenhum valor na definição da chave. Se omitido, default é assumido como uma cadeia de comprimento zero ("").

Observações

Se algum dos itens com o nome nos argumentos GetSetting não existir, GetSetting devolve o valor predefinido.

Exemplo

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza primeiro a instrução SaveSetting para fazer entradas no registo do Windows (ou .ini ficheiro em plataformas windows de 16 bits) para a aplicação especificada como appname e, em seguida, utiliza a função GetSetting para apresentar uma das definições. Uma vez que o argumento predefinido é especificado, é garantido que algum valor é devolvido. Tenha em atenção que os nomes das secções não podem ser obtidos com GetSetting. Por fim, a instrução DeleteSetting remove todas as entradas da aplicação.

' Variant to hold 2-dimensional array returned ' by GetSetting.Dim MySettings As Variant' Place some settings in the registry.SaveSetting "MyApp","Startup", "Top", 75SaveSetting "MyApp","Startup", "Left", 50Debug.Print GetSetting(appname := "MyApp", _            section := "Startup", _            key := "Left", default := "25")DeleteSetting "MyApp", "Startup"

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.