Using Events with the Document Object
|Word Developer Reference|
The Document object supports several events that enable you to respond to the state of a document. You write procedures to respond to these events in the class module named "ThisDocument." Use the following steps to create an event procedure.
- Under your Normal project or document project in the Project Explorer window, double-click ThisDocument. (In Folder view, ThisDocument is located in the Microsoft Word Objects folder.)
- Select Document from the Object drop-down list box.
An empty subroutine for the New event is added to the class module.
- Select an event from the Procedure drop-down list box.
An empty subroutine for the selected event is added to the class module.
- Add the Visual Basic instructions you want to run when the event occurs.
The following example shows a New event procedure in the Normal project that will run when a new document based on the Normal template is created.
The following example shows a Close event procedure in a document project that runs only when that document is closed.
Unlike auto macros, event procedures in the Normal template do not have a global scope. For example, event procedures in the Normal template occur only if the attached template is the Normal template.
If an auto macro exists in a document and the attached template, only the auto macro stored in the document will execute. If an event procedure for a document event exists in a document and its attached template, both event procedures will run.