Objet variable (Word)Variable object (Word)

Représente une variable stockée en tant que partie d’un document.Represents a variable stored as part of a document. Les variables de document servent à conserver les paramètres de macro entre les sessions de macro.Document variables are used to preserve macro settings in between macro sessions. L’objet variable est un membre de la collection variables .The Variable object is a member of the Variables collection. La collection variables inclut toutes les variables de document dans un document ou un modèle.The Variables collection includes all the document variables in a document or template.

RemarquesRemarks

Utilisez les variables (index), où index est le nom de la variable de document ou le numéro d’index, pour renvoyer un seul objet variable .Use Variables (Index), where Index is the document variable name or the index number, to return a single Variable object. L'exemple suivant affiche la valeur de la variable Temp dans le document actif.The following example displays the value of the Temp document variable in the active document.

MsgBox ActiveDocument.Variables("Temp").Value

Le numéro d'index représente la position de la variable de document dans la collection Variables.The index number represents the position of the document variable in the Variables collection. 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.The last variable added to the Variables collection is index number 1; the second-to-last variable added to the collection is index number 2, and so on. L'exemple suivant affiche le nom de la première variable de document dans le document actif.The following example displays the name of the first document variable in the active document.

MsgBox ActiveDocument.Variables(1).Name

Utilisez la méthode Add de la collection variables pour ajouter une variable à un document.Use the Add method of the Variables collection to add a variable to a document. L'exemple suivant ajoute une variable de document nommée « Temp » avec la valeur 12 au document actif.The following example adds a document variable named "Temp" with a value of 12 to the active document.

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.If you try to add a document variable with a name that already exists in the Variables collection, an error occurs. Pour éviter cette erreur, vous pouvez énumérer la collection avant d'ajouter de nouvelles variables.To avoid this error, you can enumerate the collection before adding any new 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.If the Blue document variable already exists in the active document, the following example sets its value to 6. Si elle n'existe pas, cet exemple l'ajoute au document et lui affecte la valeur 6.If this variable does not already exist, this example adds it to the document and sets it to 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é.Document variables are invisible to the user unless a DOCVARIABLE field is inserted with the appropriate variable name. 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.The following example adds a document variable named "Temp" to the active document and then inserts a DOCVARIABLE field to display the value in the 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 .To add a document variable to a template, open the template as a document by using the OpenAsDocument method. L'exemple suivant stocke le nom d'utilisateur (à partir de la boîte de dialogue Options ) dans le modèle attaché au document actif.The following example stores the user name (from the Options dialog box) in the template attached to the active document.

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

Voir aussiSee also

Référence du modèle objet WordWord Object Model Reference

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.