Edit

Application.BeforePrint event (Publisher)

  • Article

Occurs before the publication is printed or previewed.

Syntax

expression.BeforePrint (Doc, Cancel)

expression An expression that returns an Application object.

Parameters

Name Required/Optional Data type Description
Doc Required Document The current publication.
Cancel Required Boolean False when the event occurs. If the event procedure sets this parameter to True, the publication is not printed when the procedure finishes running.

Remarks

The BeforePrint event fires only after the document is fully loaded and the onload events have returned. Printing does not occur until the event handler is executed.

For more information about using events with the Application object, see Using events with the Application object.

Example

The following Microsoft Visual Basic for Applications (VBA) macro shows how to handle the BeforePrint event. It displays a message notifying the user that the document is about to be printed.

Private Sub pubApplication_BeforePrint(ByVal Doc As Document, Cancel As Boolean ) 
 MsgBox "Printing of " & Doc.Name & " is about to occur ." 
End Sub

For this event to occur, you must place the following line of code in the General Declarations section of your module.

Private WithEvents pubApplication As Application

You then must run the following initialization procedure.

Public Sub Initialize_pubApplication() 
 Set pubApplication = Publisher.Application 
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.