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
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.
Commentaires
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Envoyer et afficher des commentaires pour