Instrução DeleteSetting
Exclui uma seção ou uma configuração de chave da entrada de um aplicativo no registro do Windows ou (no Macintosh) no arquivo de inicialização do aplicativo.
Sintaxe
DeleteSettingappname, section, [ key ]
A sintaxe de instrução DeleteSetting tem esses 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 seção ou a configuração de 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 que contém o nome da seção em que a configuração da chave está sendo excluída. Se apenas o nome 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 que contém 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. Um erro de tempo de execução ocorrerá se você tentar usar a instrução DeleteSetting em uma seção ou configuração de chave inexistente.
Exemplo
O exemplo a seguir primeiro usa 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 chave é especificado, toda a seção é excluída, incluindo o nome da seção e todas as 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.