Remarque
La fonction, la méthode, l’objet ou la propriété décrits dans cette rubrique est désactivé si le service d’expression Microsoft Jet s’exécute en mode bac à sable, ce qui empêche l’évaluation d’expressions potentiellement dangereuses. Pour plus d’informations sur le mode bac à sable, recherchez « mode bac à sable » dans l’aide.
Renvoie une valeur de paramètre de clé à partir de l’entrée d’une application dans le Registre Windows ou (sur le Macintosh) des informations dans le fichier d’initialisation de l’application.
Syntaxe
GetSetting(appname, section, key [, default ] )
La syntaxe de la fonction GetSetting contient les arguments suivants :
| Argument | Description |
|---|---|
| Nom de l’application | Obligatoire. Expression de chaîne contenant le nom de l’application ou du projet dont le paramètre de clé est demandé. Sur le Macintosh, il s’agit du nom du fichier d’initialisation dans le dossier Préférences du dossier Système. |
| section | Obligatoire. Expression de chaîne contenant le nom de la section où se trouve le paramètre de clé. |
| Clé | Obligatoire. Expression de chaîne contenant le nom du paramètre de clé à retourner. |
| par défaut | Facultatif. Expression contenant la valeur à retourner si aucune valeur n’est définie dans le paramètre de clé. Si cette option est omise, la valeur par défaut est une chaîne nulle (« »). |
Remarques
Si l’un des éléments nommés dans les arguments GetSetting n’existe pas, GetSetting retourne la valeur par défaut.
Exemple
Remarque
Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence développeur dans la liste déroulante en regard de Rechercher , puis entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise d’abord l’instruction SaveSetting pour effectuer des entrées dans le Registre Windows (ou .ini fichier sur les plateformes Windows 16 bits) pour l’application spécifiée en tant que appname, puis utilise la fonction GetSetting pour afficher l’un des paramètres. Étant donné que l’argument par défaut est spécifié, une certaine valeur est garantie d’être renvoyée. Notez que les noms de section ne peuvent pas être récupérés avec GetSetting. Enfin, l’instruction DeleteSetting supprime toutes les entrées de l’application.
' 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"