MailMerge.ShowWizardEx method (Publisher)

Displays the specified catalog or mail merge wizard in a document.

Syntax

expression.ShowWizardEx (ShowDocumentStep, ShowTemplateStep, ShowDataStep, ShowWriteStep, ShowPreviewStep, ShowMergeStep, MergeType, iStep)

expression A variable that represents a MailMerge object.

Parameters

Name Required/Optional Data type Description
ShowDocumentStep Optional Boolean Not used in Microsoft Publisher 2007. In previous versions, True (the default) displayed the "Select a merge type" step; False removed the step.
ShowTemplateStep Optional Boolean This parameter does not apply to Microsoft Publisher.
ShowDataStep Optional Boolean Not used in Microsoft Publisher 2007. In previous versions, True (the default) displayed the "Select data source" step; False removed the step.
ShowWriteStep Optional Boolean Not used in Microsoft Publisher 2007. In previous versions, True (the default) displayed the "Create your publication" step; False removed the step.
ShowPreviewStep Optional Boolean Not used in Microsoft Publisher 2007. In previous versions, True (the default) displayed the "Preview your publication" step; False removed the step.
ShowMergeStep Optional Boolean Not used in Microsoft Publisher 2007. In previous versions, True (the default) displayed the "Complete the merge" step; False removed the step.
MergeType Optional PbMergeType The merge type to use. Can be one of the PbMergeType constants declared in the Microsoft Publisher type library. The default is pbMergeDefault.
iStep Optional Long The initial step. See Remarks for information about default values.

Remarks

Passing pbMergeDefault for MergeType starts a new mail merge; if the publication is already a merge, it leaves the merge type unchanged.

Passing a merge type that is different from the current publication's merge type changes the publication to that new type of merge, but disconnects the data source. Doing so results in the loss of previously inserted fields when the change is to or from a catalog merge type.

Wizard steps correspond to the sequence of merge task panes in the user interface. If no data source is connected, the merge wizard always starts on the first step (the first task pane). If a data source is connected, the wizard starts on Step 2 by default, unless you use the iStep parameter to specify starting with Step 1 or Step 3.

Example

This example checks whether the mail merge wizard is closed, and if it is, displays it.

Public Sub ShowWizardEx_Example() 
 With ActiveDocument.MailMerge 
 If .WizardState = 0 Then 
 .ShowWizardEx 
 End If 
 End With 
End Sub

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.