Ler em inglês

Compartilhar via


Método Fields.Add (Word)

Adiciona um objeto Field à coleção Fields . Retorna o objeto Field no intervalo especificado.

Sintaxe

expressão. Adicionar (Intervalo, Tipo, Texto, PreserveFormatting)

expressão Obrigatório. Uma variável que representa uma coleção 'Fields'.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Range Obrigatório Objeto Range O intervalo no qual você deseja incluir o campo. Se o intervalo não estiver recolhido, o campo substituirá o intervalo.
Type Opcional Variantes Pode ser qualquer constante WdFieldType. Para obter uma lista de constantes válidas, consulte o Pesquisador de objetos do Microsoft Visual Basic. O valor padrão é wdFieldEmpty.
Text Opcional Variantes Texto adicional necessário para o campo. Por exemplo, se quiser especificar uma opção para o campo, você deve acrescentá-la aqui.
PreserveFormatting Opcional Variantes True para fazer com que a formatação aplicada ao campo seja preservada durante as atualizações.

Valor de retorno

Campo

Comentários

Não é possível inserir alguns campos (como wdFieldOCX e wdFieldFormCheckBox) usando o método Add da coleção Fields. Ao contrário, você deve usar métodos específicos como AddOLEControl e Add para a coleção FormFields.

Exemplo

Este exemplo insere um campo USERNAME no início da seleção.

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

Este exemplo insere um campo LISTNUM no final da seleção. A opção de início é definida para começar em 3.

Selection.Collapse Direction:=wdCollapseEnd 
ActiveDocument.Fields.Add Range:=Selection.Range, _ 
 Type:=wdFieldListNum, Text:="\s 3"

Este exemplo 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

Confira também

Objeto da coleção Fields

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.