Nota
La función, el método, el objeto o la propiedad descritos en este tema se deshabilitan si el servicio de expresiones de Microsoft Jet se ejecuta en modo de espacio aislado, lo que impide la evaluación de expresiones potencialmente inseguras. Para obtener más información sobre el modo de espacio aislado, busque "modo de espacio aislado" en la Ayuda.
Devuelve un valor de clave de la entrada de una aplicación en el Registro de Windows o (en el Macintosh) información del archivo de inicialización de la aplicación.
Sintaxis
GetSetting(appname, section, key [, default ] )
La sintaxis de la función GetSetting consta de los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| Nombre de aplicación | Obligatorio. Expresión de cadena que contiene el nombre de la aplicación o proyecto cuya configuración de clave se solicita. En Macintosh, este es el nombre del archivo de inicialización en la carpeta Preferencias de la carpeta Sistema. |
| sección | Obligatorio. Expresión de cadena que contiene el nombre de la sección donde se encuentra la configuración de la clave. |
| clave | Obligatorio. Expresión de cadena que contiene el nombre de la configuración de clave que se va a devolver. |
| predeterminado | Opcional. Expresión que contiene el valor que se devolverá si no se establece ningún valor en la configuración de clave. Si se omite, se supone que el valor predeterminado es una cadena de longitud cero (""). |
Observaciones
Si alguno de los elementos nombrados en los argumentos GetSetting no existe, GetSetting devuelve el valor predeterminado.
Ejemplo
Nota
Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione referencia para desarrolladores en la lista desplegable situada junto a búsqueda y escriba uno o varios términos en el cuadro de búsqueda.
En primer lugar, en este ejemplo se usa la instrucción SaveSetting para realizar entradas en el Registro de Windows (o archivo .ini en plataformas Windows de 16 bits) para la aplicación especificada como appname y, a continuación, se usa la función GetSetting para mostrar una de las configuraciones. Dado que se especifica el argumento predeterminado , se garantiza que se devolverá algún valor. Tenga en cuenta que los nombres de sección no se pueden recuperar con GetSetting. Por último, la instrucción DeleteSetting quita todas las entradas de la aplicación.
' 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"