Word) 变量对象 (

代表存储为文档的一部分的变量。 文档变量用于在宏会话之间保留宏设置。 Variable 对象是 Variables 集合的成员。 Variables 集合包括文档或模板中的所有文档变量。

备注

使用 变量 (索引)，其中索引是文档变量的名称或索引号，返回单个 变量 对象。 下面的示例显示活动文档中文档变量 Temp 的值。

MsgBox ActiveDocument.Variables("Temp").Value

索引号代表文档变量在 变量 集合中的位置。 最后添加到 Variables 集合的变量的索引号为 1，倒数第二个添加到集合的变量的索引号为 2，以此类推。 下面的示例显示活动文档中第一个文档变量的名称。

MsgBox ActiveDocument.Variables(1).Name

使用 Variables 集合的 Add 方法向文档添加变量。 下面的示例将添加一个文档变量，其值为 12 至活动文档名为"Temp"。

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

如果您尝试在 Variables 集合中添加一个文档变量已经存在的名称，则会导致出错。 若要避免此错误，您可以枚举集合添加新变量之前。 如果 Blue 文档变量已经存在于活动文档中，则以下示例将其值设为 6。 如果此变量尚不存在，则以下示例将其加入文档并将其值设置为 6。

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

只有将合适的变量名插入 DOCVARIABLE 域，文档变量才是可见的。 以下示例在活动文档中添加一个名为“Temp”的文档变量，然后插入一个 DOCVARIABLE 域显示该变量的值。

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

若要将文档变量添加到模板，请使用 OpenAsDocument 方法将模板作为文档打开。 下面的示例存储在附加到活动文档的模板的用户名 (在 选项对话框中)。

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

另请参阅

Word 对象模型参考

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。