MailMergeFilters object (Publisher)

Represents all the filters to apply to the data source attached to the mail merge or catalog merge publication. The MailMergeFilters object is composed of MailMergeFilterCriterion objects.

Remarks

Use the Add method to add a new filter criterion to the query.

Use the Item method to access an individual filter criterion.

Example

This example adds a new line to the query string and then applies the combined filter to the data source. This example assumes that a data source is attached to the active publication.

Sub FilterDataSource() 
 With ActiveDocument.MailMerge.DataSource 
 .Filters.Add Column:="Region", _ 
 Comparison:=msoFilterComparisonIsBlank, _ 
 Conjunction:=msoFilterConjunctionAnd 
 .ApplyFilter 
 End With 
End Sub

This example loops through all the filter criterion and if it finds one with a value of Region, changes it to remove from the mail merge all records that are not equal to WA. This example assumes that a data source is attached to the active publication.

Sub SetQueryCriterion() 
 Dim intItem As Integer 
 With ActiveDocument.MailMerge.DataSource.Filters 
 For intItem = 1 To .Count 
 With .Item(intItem) 
 If .Column = "Region" Then 
 .Comparison = msoFilterComparisonNotEqual 
 .CompareTo = "WA" 
 If .Conjunction = "Or" Then .Conjunction = "And" 
 End If 
 End With 
 Next 
 End With 
End Sub

Methods

• Add
• Delete
• Item

Properties

• Application
• Count
• Creator
• Parent

See also

• Publisher Object Model Reference

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.