Classe Variables (Word VBA)

Uma coleção de objetos Variable que representa as variáveis adicionadas a um documento ou modelo. As variáveis de documento são usadas para preservar as configurações de macro, de uma sessão de macro para outra. Para usar uma variável de classe Variables, ela primeiro precisa ser instanciada por exemplo

Dim vrbs as Variables
Set vrbs = ActiveDocument.Variables

For Each

Aqui está um exemplo de processamento dos itens Variables em uma coleção.

Dim vrb As Variable
For Each vrb In ActiveDocument.Variables
	
Next vrb

Add

Retorna um objeto Variable que representa uma variável adicionada a um documento.

Variáveis de documento são invisíveis para o usuário, a menos que um campo DOCVARIABLE seja inserido com o nome da variável apropriado. Se você tentar adicionar uma variável com um nome que já existe na coleção Variables, ocorrerá um erro. Para evitar esse erro, você pode enumerar a coleção antes de adicionar uma nova variável a ela.

Add (Name, Value)

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

Arguments

O seguinte argumento é necessário

Name (String) - O nome da variável de documento.

Optional arguments

The following argument is optional

Value (Variant) - O valor da variável de documento.

Count

Retorna um Long que representa o número de variáveis na coleção.

Dim lngCount As Long
lngCount = ActiveDocument.Variables.Count

Item

Retorna um objeto Variable individual em uma coleção.

Item (Index)

Index: O objeto individual a ser retornado. Pode ser um Long que indica a posição ordinal ou uma cadeia de caracteres que representa o nome do objeto individual.

Dim vrb As Variable
Set vrb = ActiveDocument.Variables(Index:=1)