Variablenobjekt (Word)

Stellt eine Variable dar, die als Teil eines Dokuments abgelegt wird. Dokumentvariablen werden verwendet, um Makroeinstellungen zwischen Makrositzungen zu speichern. Das Variable-Objekt ist ein Element der Variables-Auflistung . Die Variables-Auflistung enthält alle Dokumentvariablen in einem Dokument oder einer Vorlage.

HinwBemerkungeneise

Verwenden Sie Variablen (Index), wobei Index der Name der Dokumentvariable oder die Indexnummer ist, um ein einzelnes Variable-Objekt zurückzugeben. Im folgenden Beispiel wird der Wert der Variablen Temp-Dokument im aktiven Dokument angezeigt.

MsgBox ActiveDocument.Variables("Temp").Value

Die Indexnummer stellt die Position der Dokumentvariablen in der Variables-Auflistung dar. Die letzte zur Variables-Auflistung hinzugefügte Variable ist Indexnummer 1, die vorletzte hinzugefügte Variable ist Indexnummer 2 usw. Im folgenden Beispiel wird der Name der ersten Dokumentvariablen im aktiven Dokument angezeigt.

MsgBox ActiveDocument.Variables(1).Name

Verwenden Sie die Add-Methode der Variables-Auflistung , um einem Dokument eine Variable hinzuzufügen. Im folgenden Beispiel wird dem aktiven Dokument die Dokumentvariable „Temp" mit dem Wert 12 hinzugefügt.

ActiveDocument.Variables.Add Name:="Temp", Value:="12"

Wenn Sie versuchen, eine Dokumentvariable mit einem Namen hinzuzufügen, der sich bereits in der Variables-Auflistung befindet, tritt ein Fehler auf. Dieser Fehler wird vermieden, wenn Sie die Auflistung aufzählen, bevor Sie neue Variablen hinzufügen. Ist im aktiven Dokument die Dokumentvariable „Blue" bereits vorhanden, wird im folgenden Beispiel dafür der Wert 6 festgelegt. Ist dies nicht der Fall, wird die Variable mit dem Wert 6 hinzugefügt.

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

Dokumentvariablen werden so lange für den Benutzer ausgeblendet, bis ein DOCVARIABLE-Feld mit dem geeigneten Namen für die Variable eingefügt wird. Im folgenden Beispiel wird dem aktiven Dokument die Dokumentvariable Temp hinzugefügt und anschließend ein DOCVARIABLE-Feld eingefügt, um den Wert in der Variablen 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

Um einer Vorlage eine Dokumentvariable hinzuzufügen, öffnen Sie die Vorlage mit der OpenAsDocument-Methode als Dokument. Im folgenden Beispiel wird der Benutzername (aus dem Dialogfeld Optionen) in der Vorlage gespeichert, die mit dem aktiven Dokument verbunden ist.

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

Siehe auch

Referenz zum Word-Objektmodell

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.