Fields.Add, méthode (Word)
Ajoute un objet Field à la collection Fields . Renvoie l’objet Field à la plage spécifiée.
expression. Add (Plage, Type, Texte, PreserveFormatting)
expression Obligatoire. Variable qui représente une collection « Fields ».
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. |
Field
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.
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
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.