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.