Variables.Add-Methode (Word)

  • Artikel

Gibt ein Variable-Objekt zurück, das eine Variable darstellt, die einem Dokument hinzugefügt wurde.

Syntax

Ausdruck. Hinzufügen (Name, Wert)

Ausdruck: Erforderlich. Eine Variable, die eine Variablenauflistung darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Name Erforderlich String Der Name der Dokumentvariablen.
Wert Optional Variant Der Wert für die Dokumentvariable.

Rückgabewert

Variable

HinwBemerkungeneise

Dokumentvariablen werden so lange für den Benutzer ausgeblendet, bis ein DOCVARIABLE-Feld mit dem geeigneten Namen für die Variable eingefügt wird. Wenn Sie versuchen, eine Variable hinzuzufügen, deren Name in der Variables-Auflistung bereits vorhanden ist, tritt ein Fehler auf. Dieses können Sie vermeiden, indem Sie die Auflistung durchlaufen, bevor Sie eine neue Variable hinzufügen.

Beispiel

In diesem Beispiel wird eine Variable mit dem Namen Temp zum aktiven Dokument hinzugefügt, und anschließend wird ein DOCVARIABLE-Feld eingefügt, um den Wert der Variablen Temp anzuzeigen.

With ActiveDocument 
 .Variables.Add Name:="Temp", Value:="12" 
 .Fields.Add Range:=Selection.Range, _ 
 Type:=wdFieldDocVariable, Text:="Temp" 
End With 
ActiveDocument.ActiveWindow.View.ShowFieldCodes = False

In diesem Beispiel wird der Wert der Variablen Blue auf 6 festgelegt. Wenn diese Variable noch nicht vorhanden ist, wird sie in diesem Beispiel dem Dokument hinzugefügt und auf 6 festgelegt.

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

In diesem Beispiel wird der Benutzername (aus dem Dialogfeld Optionen) in der dem aktiven Dokument angefügten Vorlage gespeichert.

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

Siehe auch

Variables-Auflistung (Objekt)

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.