Propriété System.PrivateProfileString (Word)

  • Article

Cette propriété renvoie ou définit une chaîne dans un fichier de paramètres ou le Registre Microsoft Windows. String en lecture/écriture.

Syntaxe

expression. PrivateProfileString( _FileName_ , _Section_ , _Key_ )

Expression Expression qui renvoie un objet « System ».

Parameters

Nom Requis/Facultatif Type de données Description
FileName Obligatoire Chaîne Nom du fichier de paramètres. Si aucun chemin d'accès n'est spécifié, le dossier Windows est utilisé par défaut.
Section Obligatoire Chaîne Nom de la section contenant la Clé dans le fichier de paramètres. Dans un fichier de paramètres Windows, le nom de la section apparaît entre crochets avant les touches associées (n’incluez pas les crochets avec Section). Si vous renvoyez la valeur d'une entrée à partir du registre Windows, l'argument Section doit correspondre au chemin d'accès complet de la sous-clé, sous-arborescence comprise (par exemple, "HKEY_CURRENT_USER\Software\Microsoft\Office\version\Word\Options").
Key Obligatoire Chaîne Paramètre de la clé ou valeur de l'entrée du registre à récupérer. Dans un fichier de paramètres Windows, le nom de la clé est suivi d'un signe égal (=) et du paramètre. Si vous renvoyez la valeur d'une entrée à partir du registre Windows, l'argument Clé doit correspondre au nom d'une entrée de la sous-clé spécifiée par l'argument Section (par exemple, "STARTUP-PATH").

Remarques

Vous pouvez rédiger des macros qui utilisent un fichier de paramètres afin de stocker et de récupérer des paramètres. Par exemple, vous pouvez stocker le nom du document actif lorsque vous quittez Microsoft Word afin de pouvoir l'ouvrir de nouveau automatiquement lors du redémarrage de Word. Un fichier de paramètres est un fichier texte contenant des informations organisées comme celles du fichier WIN.INI de Windows 3.x.

Exemple

Cet exemple montre comment définir le nom du document actuel en tant que paramètre LastFile sous le titre MacroSettings du fichier Settings.txt.

System.PrivateProfileString("C:\Settings.txt", "MacroSettings", _ 
 "LastFile") = ActiveDocument.FullName

Cet exemple montre comment renvoyer le paramètre LastFile à partir du fichier Settings.txt, puis ouvrir le document stocké dans LastFile.

LastFile = System.PrivateProfileString("C:\Settings.Txt", _ 
 "MacroSettings", "LastFile") 
If LastFile <> "" Then Documents.Open FileName:=LastFile

Cet exemple montre comment afficher la valeur de l'entrée EmailName à partir du registre Windows.

aName = System.PrivateProfileString("", _ 
 "HKEY_CURRENT_USER\Software\Microsoft\" _ 
 & "Windows\CurrentVersion\Internet Settings", "EmailName") 
MsgBox aName

Voir aussi

Objet système

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.