Objet variable (Word)

Représente une variable stockée dans le cadre d’un document. Les variables de document servent à conserver les paramètres de macro entre les sessions de macro. L’objet Variable est membre de la collection Variables . La collection Variables inclut toutes les variables de document dans un document ou un modèle.

Remarques

Utiliser des Variables (Index), où Index est le nom de la variable de document ou le numéro d'index, pour renvoyer un seul objet Variable. L'exemple suivant affiche la valeur de la variable Temp dans le document actif.

MsgBox ActiveDocument.Variables("Temp").Value

Le numéro d'index représente la position de la variable de document dans la collection Variables. La dernière variable ajoutée à la collection Variables est le numéro d'index 1 ; l'avant-dernière ajoutée à cette collection est le numéro d'index 2, etc. L'exemple suivant affiche le nom de la première variable de document dans le document actif.

MsgBox ActiveDocument.Variables(1).Name

Utilisez la méthode Add de la collection Variables pour ajouter une variable à un document. L'exemple suivant ajoute une variable de document nommée « Temp » avec la valeur 12 au document actif.

ActiveDocument.Variables.Add Name:="Temp", Value:="12"

Si vous essayez d'ajouter une variable de document avec un nom qui existe déjà dans la collection Variables, une erreur se produit. Pour éviter cette erreur, vous pouvez énumérer la collection avant d'ajouter de nouvelles variables. Dans le cas où la variable de document Blue existe déjà dans le document actif, l'exemple suivant lui affecte la valeur 6. Si elle n'existe pas, cet exemple l'ajoute au document et lui affecte la valeur 6.

For Each aVar In ActiveDocument.Variables 
 If aVar.Name = "Blue" Then num = aVar.Index 
Next aVar 
If num = 0 Then 
 ActiveDocument.Variables.Add Name:="Blue", Value:=6 
Else 
 ActiveDocument.Variables(num).Value = 6 
End If

Les variables de document sont invisibles pour l'utilisateur, à moins que le champ DOCVARIABLE ne soit inséré avec le nom de variable approprié. L'exemple suivant montre comment ajouter une variable de document « Temp » au document actif, puis insérer un champ DOCVARIABLE pour afficher la valeur de la variable.

With ActiveDocument 
 .Variables.Add Name:="Temp", Value:="12" 
 .Fields.Add Range:=Selection.Range, _ 
 Type:=wdFieldDocVariable, Text:="Temp" 
End With 
ActiveDocument.ActiveWindow.View.ShowFieldCodes = False

Pour ajouter une variable de document à un modèle, ouvrez le modèle en tant que document à l’aide de la méthode OpenAsDocument . L'exemple suivant stocke le nom d'utilisateur (à partir de la boîte de dialogue Options ) dans le modèle attaché au document actif.

ScreenUpdating = False 
With ActiveDocument.AttachedTemplate.OpenAsDocument 
 .Variables.Add Name:="UserName", Value:=Application.UserName 
 .Close SaveChanges:=wdSaveChanges 
End With

Voir aussi

Référence du modèle objet Word

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.