Item-Level Events

Item-level events occur when something happens to an item displayed in a form, such as when it's saved or opened or when a user-defined action is started. Most often, item-level events are handled by Microsoft Visual Basic Scripting Edition (VBScript) code within the form itself. Some events can be cancelled. That is, your event handler can prevent Microsoft Outlook from performing the default action associated with the event. For example, you can write an event handler for the Forward event to prevent an item from being sent to recipients who are not on a list of approved recipients. Learn about canceling an event. The following table lists the item-level events supported by Outlook.

Event Cancelable? Description
AttachmentAdd No Occurs when an attachment has been added to the item
AttachmentRead No Occurs when an attachment has been opened for reading
AttachmentRemove No Occurs when an attachment has been removed from an item
BeforeAttachmentAdd Yes Occurs before an attachment is added to an item
BeforeAttachmentPreview Yes Occurs before an attachment associated with an item is previewed
BeforeAttachmentRead Yes Occurs before an attachment associated with an item is read from the file system, an attachment stream, or an Attachment object
BeforeAttachmentSave Yes Occurs just before an attachment is saved into the Outlook item
BeforeAttachmentWriteToTempFile Yes Occurs before an attachment associated with an item is written to a temporary file
BeforeAutoSave Yes Occurs before the item is automatically saved by Outlook
BeforeCheckNames Yes Occurs before Outlook starts resolving names in the recipients collection of the item
BeforeDelete Yes Occurs before Outlook deletes an item that has been opened in an inspector
Close Yes Occurs before Outlook closes the inspector displaying the item
CustomAction Yes Occurs before Outlook executes a custom action of an item
CustomPropertyChange No Occurs when a custom item property has changed
Forward Yes Occurs before Outlook executes the Forward action of an item
Open Yes Occurs before Outlook opens an inspector to display the item
PropertyChange No Occurs when an item property has changed
Read No Occurs when an item is opened for editing by a user
Reply Yes Occurs before Outlook executes the Reply action of an item
ReplyAll Yes Occurs before Outlook executes the Reply to All action of an item
Send Yes Occurs before Outlook sends the item
Unload No Occurs before an Outlook item is unloaded from memory, either programmatically or by user action
Write Yes Occurs before Outlook saves the item in a folder

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.