Compartilhar via


Método MailMergeFields.AddSkipIf (Word)

Adiciona um campo SKIPIF a um documento principal de mesclagem de email. Retorna um objeto MailMergeField. .

Sintaxe

expression. AddSkipIf( _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 SKIPIF.
Mergefield Obrigatório String O nome do campo de mala direta.
Comparison Obrigatório WdMailMergeComparison O operador utilizado na comparação.
CompareTo Opcional Variant O texto a ser comparado com o conteúdo de MergeField.

Valor de retorno

MailMergeField

Comentários

Um campo SKIPIF compara duas expressões e, quando a comparação é verdadeira, SKIPIF vai para o próximo registro da fonte de dados e inicia um novo documento de mala direta.

Exemplo

Este exemplo adiciona um campo SKIPIF antes do primeiro campo MERGEFIELD de Main.doc. Se o próximo código postal for igual a 98040, o registro seguinte será ignorado.

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

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.