Share via


Objeto Fields (Word)

Uma coleção de campo objetos que representam todos os campos em uma seleção, intervalo ou documento.

Comentários

Use a propriedade Fields para retornar a coleção Fields. O exemplo seguinte atualiza todos os campos da seleção.

Observação

[!OBSERVAçãO] Use a propriedade Fields com um objeto MailMerge para retornar uma coleção MailMergeFields.

Selection.Fields.Update

Use a Adicionar método para adicionar um campo à coleção Fields. O exemplo a seguir insere um campo DATE no início da seleção e exibe o resultado.

Selection.Collapse Direction:=wdCollapseStart 
Set myField = ActiveDocument.Fields.Add(Range:=Selection.Range, _ 
 Type:=wdFieldDate) 
MsgBox myField.Result

Use os campos (Index), onde Index é o número de índice, para retornar um único objeto Field. O número de índice representa a posição do campo na seleção, intervalo ou documento. O exemplo a seguir exibe o código de campo e o resultado do primeiro campo do documento ativo.

If ActiveDocument.Fields.Count >= 1 Then 
 MsgBox "Code = " & ActiveDocument.Fields(1).Code & vbCr _ 
 & "Result = " & ActiveDocument.Fields(1).Result & vbCr 
End If

A propriedade Count dessa coleção em um documento retorna o número de itens no texto principal. Para contar itens em outros textos usam a coleção com o objeto de intervalo.

Confira também

Referência do modelo de objeto do Word

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.