Variables Objekt (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.
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
Referenz zum Word-Objektmodell
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.