Объект переменной (Word)

Представляет переменную, хранящуюся в документе. Переменные документа используются для сохранения настроек макросов между сеансами макросов. Объект Variable входит в семейство переменных . Коллекция "Переменные" включает все переменные документа или шаблона.

Примечания

Используйте переменные (Индекс), где Индекс — это имя переменной документа или номер индекса, чтобы вернуть один объект переменной . В следующем примере отображается значение переменной документа Temp в активном документе.

MsgBox ActiveDocument.Variables("Temp").Value

Номер индекса представляет позицию переменной документа в семействе переменных . Последняя переменная, добавленная в коллекцию переменных, является индексом номер 1; Предпоследняя переменная, добавляемая в коллекцию, имеет номер индекса 2, и так далее. В следующем примере отображается имя первой переменной документа в активном документе.

MsgBox ActiveDocument.Variables(1).Name

Чтобы добавить переменную в документ, используйте метод Add из коллекции Variables . В следующем примере в активный документ добавляется переменная документа с именем "Temp" и значением 12.

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

При попытке добавить переменную документа с именем, которое уже существует в коллекции переменных , возникает ошибка. Чтобы избежать этой ошибки, можно выполнить перечисление коллекции перед добавлением новых переменных. Если переменная "Синий документ" уже существует в активном документе, в следующем примере ее значение равно 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 и обратная связь.