Fields.Add-Methode (Word)

Fügt der Fields-Auflistung ein Field-Objekt hinzu. Gibt das Field -Objekt im angegebenen Bereich zurück.

Syntax

Ausdruck. Hinzufügen (Range, Type, Text, PreserveFormatting)

expression Erforderlich. Eine Variable, die eine Fields-Auflistung darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Range Erforderlich Range-Objekt Der Bereich, in dem Sie das Feld hinzufügen möchten. Wenn der Bereich nicht reduziert ist, ersetzt das Feld den Bereich.
Type Optional Variant Dies kann eine beliebige WdFieldType-Konstante sein. Eine Liste der gültigen Konstanten finden Sie im Objektkatalog. Der Standardwert ist wdFieldEmpty.
Text Optional Variant Zusätzlich für das Feld benötigter Text. Wenn Sie zum Beispiel einen Schalter für das Feld angeben möchten, fügen Sie ihn hier hinzu.
PreserveFormatting Optional Variant True, um die dem Feld zugewiesene Formatierung bei Aktualisierungen beizubehalten.

Rückgabewert

Feld

Hinweise

Einige Felder (z. B. wdFieldOCX und wdFieldFormCheckBox) können nicht mit der Add-Methode der Fields-Auflistung eingefügt werden. Stattdessen müssen Sie spezielle Methoden verwenden, z. B. die AddOLEControl-Methode und die Add-Methode für die FormFields-Auflistung.

Beispiel

In diesem Beispiel wird ein USERNAME-Feld am Anfang der Markierung eingefügt.

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

In diesem Beispiel wird ein LISTNUM-Feld am Ende der Markierung eingefügt. Der Startschalter ist so festgelegt, dass er bei 3 beginnt.

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

In diesem Beispiel wird ein DATE-Feld am Anfang der Markierung eingefügt und anschließend das Ergebnis angezeigt.

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

Siehe auch

Fields-Auflistungsobjekt

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.