Instrução DeleteSetting

Exclui uma seção ou configuração de chave da entrada de um aplicativo no Registro do Windows ou (no Macintosh) informações no arquivo de inicialização do aplicativo.

Sintaxe

DeleteSettingappname, section, [ key ]

A sintaxe da instrução DeleteSetting tem estes argumentos nomeados:

Sair Descrição
appname Obrigatório. Expressão de cadeia de caracteres que contém o nome do aplicativo ou projeto ao qual a configuração de seção ou chave se aplica. 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 contendo o nome da seção em que a configuração de chave está sendo excluída. Se apenas o nome do aplicativo e a seção forem fornecidos, a seção especificada será excluída junto com todas as configurações de chave relacionadas.
key Opcional. Expressão de cadeia de caracteres contendo o nome da configuração de chave que está sendo excluída.

Comentários

Se todos os argumentos forem fornecidos, a configuração especificada será excluída. Ocorrerá um erro em tempo de execução se você tentar usar a instrução DeleteSetting em uma seção ou configuração de chave inexistente.

Exemplo

O exemplo a seguir usa primeiro a instrução SaveSetting para fazer entradas no Registro do Windows (ou .ini arquivo em plataformas Windows de 16 bits) para o aplicativo e, em seguida, usa a instrução DeleteSetting para removê-las. Como nenhum argumento de chave é especificado, toda a seção é excluída, incluindo o nome da seção e todas as suas chaves.

' Place some settings in the registry. 
SaveSetting appname := "MyApp", section := "Startup", _ 
 key := "Top", setting := 75 
SaveSetting "MyApp", "Startup", "Left", 50 
' Remove section and all its settings from registry. 
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.