Compartilhar via


Método MailMergeFields.AddNextIf (Word)

Adiciona um campo NEXTIF a um documento principal de mala direta. Retorna um objeto MailMergeField.

Sintaxe

expression. AddNextIf( _Range_ , _MergeField_ , _Comparison_ , _CompareTo_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Range Obrigatório Objeto Range A posição do campo NEXTIF.
Mergefield Obrigatório String O nome do campo de mala direta.
Comparison Obrigatório WdMailMergeComparison O operador utilizado na comparação.
CompareTo Obrigatório String O texto a ser comparado com o conteúdo de MergeField.

Valor de retorno

MailMergeField

Comentários

Um campo NEXTIF compara duas expressões e, quando a comparação é verdadeira, o próximo registro é mesclado no documento de mala direta atual.

Exemplo

Este exemplo adiciona um campo NEXTIF antes do primeiro campo MERGEFIELD de Main.doc. Se o próximo código postal for igual a 98004, o próximo registro será mesclado no documento de mala direta atual.

Documents("Main.doc").MailMerge.Fields(1).Select 
Selection.Collapse Direction:=wdCollapseStart 
Documents("Main.doc").MailMerge.Fields.AddNextIf _ 
 Range:=Selection.Range, MergeField:="PostalCode", _ 
 Comparison:=wdMergeIfEqual, CompareTo:="98004"

Confira também

Objeto da coleção MailMergeFields

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.