Objeto Fields (Word)Fields object (Word)

Uma coleção de objetos Field que representa todos os campos em uma seleção, intervalo ou documento.A collection of Field objects that represent all the fields in a selection, range, or document.

ComentáriosRemarks

Use a propriedade Fields para retornar a coleção Fields.Use the Fields property to return the Fields collection. O exemplo seguinte atualiza todos os campos da seleção.The following example updates all the fields in the selection.

Observação

[!OBSERVAçãO] Use a propriedade Fields com um objeto MailMerge para retornar uma coleção MailMergeFields.Use the Fields property with a MailMerge object to return a MailMergeFields collection.

Selection.Fields.Update

Use a Adicionar método para adicionar um campo à coleção Fields.Use the Add method to add a field to the Fields collection. O exemplo a seguir insere um campo DATE no início da seleção e exibe o resultado.The following example inserts a DATE field at the beginning of the selection and then displays the result.

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

Use campos (index), onde index é o número de índice, para retornar um único objeto Field .Use Fields (Index), where Index is the index number, to return a single Field object. O número de índice representa a posição do campo na seleção, intervalo ou documento.The index number represents the position of the field in the selection, range, or document. O exemplo a seguir exibe o código de campo e o resultado do primeiro campo do documento ativo.The following example displays the field code and the result of the first field in the active document.

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.To count items in other stories use the collection with the Range object.

Confira tambémSee also

Referência do modelo de objeto do WordWord Object Model Reference

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.