Função ObterDefinição

Nota: Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

Nota: A função, método, objeto ou propriedade descritas neste tópico é desativada se o serviço do Microsoft Jet expressão estiver em execução no modo sandbox, que impede a avaliação de expressões potencialmente inseguros. Para obter mais informações sobre o modo sandbox, procure "o modo sandbox" na ajuda.

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

Sintaxe

ObterDefinição ( nome secção, chave [predefinição ] )

A sintaxe da funçãogGetSettintem os seguintes argumentos:

Argumento

Descrição

nome

Obrigatório. expressão de cadeia que contém o nome da aplicação ou projecto cujas definições chave são pedida. No Macintosh, este é o nome de ficheiro do ficheiro inicialização na pasta preferências na pasta do sistema.

secção

Obrigatório. Cadeia da expressão que contém o nome da secção onde se encontram a definição de chave.

chave

Obrigatório. Cadeia da expressão que contém o nome da definição chave para devolver.

predefinição

Opcional. Expressão que contém o valor a devolver se nenhum valor está definido na definição chave. Se for omitido, é considerada definiçãoPre para ser uma cadeia de comprimento zero ("").


Observações

Se qualquer um dos itens com nome nos argumentos ObterDefinição não existir, ObterDefinição devolve o valor de 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 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 pela primeira vez a instrução de SaveSetting para tornar as entradas no Windows registo (ou ficheiro. ini plataformas de Windows de 16 bits) para a aplicação especificada como nomee, em seguida, utiliza a função ObterDefinição para apresentar um da definições. Uma vez que o argumento predefinido é especificado, algum valor se garante a ser devolvido. Tenha em atenção que os nomes de secção não não possível obter com ObterDefinição. Por fim, a declaração de DeleteSetting remove as entradas de todas as aplicações.

' 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"
Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×