Microsoft Office

Working with Excel Events 43
Your code can, of course, make use of information passed as an argument. The following example displays
the name of the activated sheet by accessing the argument’s Name property. The argument becomes either a
Worksheet object or a Chart object.
Private Sub Workbook_SheetActivate(ByVal Sh As Object)
MsgBox Sh.Name & “ was activated.”
End Sub
Several event-handler procedures use a Boolean argument named Cancel. For example, the declaration
for a workbook’s BeforePrint event is
Private Sub Workbook_BeforePrint(Cancel As Boolean)
The value of Cancel passed to the procedure is False. However, your code can set Cancel to True,
which cancels the printing. The following example demonstrates this:
Private Sub Workbook_BeforePrint(Cancel As Boolean)
Msg = “Have you loaded the 5164 label stock? “
Ans = MsgBox(Msg, vbYesNo, “About to print... “)
If Ans = vbNo Then Cancel = True
End Sub
The Workbook_BeforePrint procedure executes before the workbook prints. This procedure displays a
message box asking the user to verify that the correct label stock is loaded. If the user clicks the No button,
Cancel is set to True, and nothing prints.
Using Workbook-Level Events
Workbook-level events occur for a particular workbook. Table 43.1 lists the most commonly used workbook
events, along with a brief description of each. Keep in mind that workbook event-handler procedures
must be stored in the code module for the ThisWorkbook object.
TABLE 43.1
Event
Activate
AddinInstall
AddinUninstall
BeforeClose
BeforePrint
BeforeSave
Deactivate
NewSheet
Workbook Events
Action That Triggers the Event
The workbook is activated.
The workbook is installed as an add-in.
The workbook is uninstalled as an add-in.
The workbook is about to be closed.
The workbook (or anything in it) is about to be printed.
The workbook is about to be saved.
The workbook is deactivated.
A new sheet is created in the workbook.
continued
747