Instrução DeleteSetting
Elimina uma definição de secção ou chave da entrada de uma aplicação no registo do Windows ou (no Macintosh) no ficheiro de inicialização da aplicação.
Sintaxe
DeleteSettingappname, section, [ key ]
A sintaxe da instrução DeleteSetting tem estes argumentos nomeados:
| Sair | Descrição |
|---|---|
| appname | Obrigatório. Expressão de cadeia que contém o nome da aplicação ou projeto ao qual se aplica a secção ou definição de chave. No Macintosh, este é o nome de ficheiro do ficheiro de inicialização na pasta Preferências na pasta Sistema. |
| section | Obrigatório. Expressão de cadeia que contém o nome da secção onde a definição de chave está a ser eliminada. Se apenas forem fornecidos nomes de aplicações e secções , a secção especificada é eliminada juntamente com todas as definições de chave relacionadas. |
| key | Opcional. Expressão de cadeia que contém o nome da definição de chave que está a ser eliminada. |
Comentários
Se todos os argumentos forem fornecidos , a definição especificada é eliminada. Ocorre um erro de tempo de execução se tentar utilizar a instrução DeleteSetting numa secção ou definição de chave inexistente.
Exemplo
O exemplo seguinte 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 e, em seguida, utiliza a instrução DeleteSetting para removê-las. Uma vez que não é especificado nenhum argumento chave , toda a secção é eliminada, incluindo o nome da secção e todas as respetivas 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.