GetSetting, fonction

Remarque : Nous faisons de notre mieux pour vous fournir le contenu d’aide le plus récent aussi rapidement que possible dans votre langue. Cette page a été traduite automatiquement et peut donc contenir des erreurs grammaticales ou des imprécisions. Notre objectif est de faire en sorte que ce contenu vous soit utile. Pouvez-vous nous indiquer en bas de page si ces informations vous ont aidé ? Voici l’article en anglais à des fins de référence aisée.

Remarque : Si le Service Microsoft Jet Expression s’exécute en mode sandbox, qui empêche l’évaluation des expressions potentiellement dangereuses de la fonction, une méthode, un objet ou une propriété décrites dans cette rubrique est désactivée. Pour plus d’informations sur le mode sandbox, recherchez « mode sandbox » dans l’aide.

Renvoie une valeur de clé à partir d’une entrée d’application dans le Registre Windows ou (sur Macintosh) des informations dans le fichier de l’initialisation de l’application.

Syntaxe

GetSetting ( appname section, clé [par défaut ] )

La syntaxe de la fonctiongGetSettincomporte les arguments suivants :

Argument

Description

appname

Obligatoire. expression de chaîne contenant le nom de l’application ou le projet dont le paramètre de clé est demandé. Sur Macintosh, il s’agit du nom du fichier d’initialisation dans le dossier Préférences dans le 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 de la valeur de clé à retourner.

par défaut

Facultatif. Expression contenant la valeur à renvoyer si aucune valeur n’est définie dans le paramètre de clé. En cas d’omission, définitionpar défaut est supposé égal à une chaîne de longueur nulle (« »).


Notes

Si un des éléments nommés dans les arguments GetSetting n’existe pas, GetSetting renvoie la valeur par défaut.

Exemple

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de recherche et entrez un ou plusieurs termes dans la zone de recherche.

Cet exemple utilise d’abord l’instruction SaveSetting pour entrer des données dans le Registre Windows (ou le fichier sur les plateformes Windows 16 bits) pour l’application spécifiée comme nom_applicationet puis utilise la fonction GetSetting pour afficher l’un de le Paramètres. L’argument par défaut étant spécifié, une valeur est garantie à renvoyer. Notez que les noms de section ne peuvent pas être extraits 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"
Développez vos compétences dans Office
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×