Instrucción DeleteSettingDeleteSetting statement

Elimina una sección o configuración de clave de la entrada de una aplicación en el Registro de Windows o (en Macintosh) información del archivo de inicialización de la aplicación.Deletes a section or key setting from an application's entry in the Windows registry or (on the Macintosh) information in the application's initialization file.

SintaxisSyntax

DeleteSetting appname, sección, [ clave ]DeleteSetting appname, section, [ key ]


La sintaxis de la instrucción DeleteSetting tiene estos argumentos con nombre:The DeleteSetting statement syntax has these named arguments:

PartPart DescripciónDescription
appnameappname Necesario.Required. Expresión de cadena que contiene el nombre de la aplicación o proyecto al que se aplica la sección o configuración de clave.String expression containing the name of the application or project to which the section or key setting applies. En Macintosh, es el nombre de archivo del archivo de inicialización que se encuentra en la carpeta Preferencias de la carpeta Sistema.On the Macintosh, this is the filename of the initialization file in the Preferences folder in the System folder.
sectionsection Necesario.Required. Cadena de expresión que contiene el nombre de la sección en la que se va a eliminar la configuración de clave.String expression containing the name of the section where the key setting is being deleted. Si solo se proporcionan las partes appname y section, la sección especificada se elimina junto con todas las configuraciones de clave.If only appname and section are provided, the specified section is deleted along with all related key settings.
keykey Opcional.Optional. Expresión de cadena que contiene el nombre de la configuración de clave que se va a eliminar.String expression containing the name of the key setting being deleted.

ObservacionesRemarks

Si se proporcionan todos los argumentos, se elimina la configuración especificada.If all arguments are provided, the specified setting is deleted. Si intenta usar la instrucción DeleteSetting en una sección o configuración de clave que no existe, ocurrirá un error en tiempo de ejecución.A run-time error occurs if you attempt to use the DeleteSetting statement on a non-existent section or key setting.

EjemploExample

En el ejemplo siguiente, primero se usa la instrucción SaveSetting para crear entradas en el Registro de Windows (o archivo .ini en plataformas Windows de 16 bits) para la aplicación y, después, se usa la instrucción DeleteSetting para quitarlas.The following example first uses the SaveSetting statement to make entries in the Windows registry (or .ini file on 16-bit Windows platforms) for the application, and then uses the DeleteSetting statement to remove them. Debido a que no se especifica ningún argumento key, se elimina toda la sección, incluido el nombre de la sección y todas sus claves.Because no key argument is specified, the whole section is deleted, including the section name and all its keys.

' 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"

Vea tambiénSee also

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.