Lire en anglais

Partager via


Fields.Add, méthode (Word)

Ajoute un objet Field à la collection Fields . Renvoie l’objet Field à la plage spécifiée.

Syntaxe

expression. Add (Plage, Type, Texte, PreserveFormatting)

expression Obligatoire. Variable qui représente une collection « Fields ».

Parameters

Nom Requis/Facultatif Type de données Description
Range Obligatoire Range (objet) Plage où vous souhaitez ajouter le champ. Si la plage n'est pas réduite, le champ remplace la plage.
Type Facultatif Variant Il peut s'agir d'une des constantes WdFieldType. Pour obtenir une liste des constantes valides, consultez l'Explorateur d'objets. La valeur par défaut est wdFieldEmpty.
Texte Facultatif Variant Texte supplémentaire qui peut être nécessaire pour le champ. Vous pouvez l'utiliser, par exemple, pour ajouter un commutateur.
PreserveFormatting Facultatif Variant True : pour conserver le format du champ lors des mises à jour.

Valeur renvoyée

Field

Remarques

Certains champs (notamment wdFieldOCX et wdFieldFormCheckBox) ne peuvent pas être insérés au moyen de la méthode Add de la collection Fields. Vous devez utiliser des méthodes spécifiques comme AddOLEControl ou la méthode Add pour la collection FormFields.

Exemple

Cet exemple montre comment insérer un champ « UserName » au début de la sélection.

Selection.Collapse Direction:=wdCollapseStart 
Set myField = ActiveDocument.Fields.Add(Range:=Selection.Range, _ 
 Type:=wdFieldUserName)

Cet exemple montre comment insérer un champ « ListNum » à la fin de la sélection. Le commutateur de départ est fixé à 3.

Selection.Collapse Direction:=wdCollapseEnd 
ActiveDocument.Fields.Add Range:=Selection.Range, _ 
 Type:=wdFieldListNum, Text:="\s 3"

Cet exemple montre comment insérer un champ « Date » au début de la sélection, puis afficher le résultat.

Selection.Collapse Direction:=wdCollapseStart 
Set myField = ActiveDocument.Fields.Add(Range:=Selection.Range, _ 
 Type:=wdFieldDate) 
MsgBox myField.Result

Voir aussi

Fields, Collection d'objets

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.