Nota: La función, método, objeto o propiedad descrita en este tema se deshabilita si el Servicio de expresiones de Microsoft Jet se ejecuta en modo de espacio aislado, lo que impide la evaluación de expresiones potencialmente no seguras. Para obtener más información sobre el modo de espacio aislado, busca "modo de espacio aislado" en la Ayuda.
Devuelve un valor de configuración de clave de la entrada de una aplicación en el Registro de Windows o (en Macintosh) en el archivo de inicialización de la aplicación.
Sintaxis
GetSetting ( nombre de aplicación , sección, tecla [, predeterminado ] )
La sintaxis de la función GetSetting tiene estos argumentos:
Argumento |
Descripción |
Appname |
Requerido. 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 de archivo del archivo de inicialización en la carpeta Preferencias de la carpeta Sistema. |
sección |
Requerido. Expresión de cadena que contiene el nombre de la sección donde se encuentra la configuración de clave. |
key |
Requerido. 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 suponeque la función desviada es una cadena de longitud cero (""). |
Observaciones
Si no existe alguno de los elementos denominados en los argumentos GetSetting , 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.
Este ejemplo usa primero la instrucción SaveSetting para realizar entradas en el Registro de Windows (o .ini archivo en plataformas de Windows de 16 bits) para la aplicación especificada como nombre de aplicación y, a continuación, usa la función GetSetting para mostrar una de las opciones de configuración. Dado que se especifica el argumento predeterminado , se garantiza que algún valor se devuelve. 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"