MailItem.Close Event (Outlook)

Office 2013 and later

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed.

expression .Close(Cancel)

expression A variable that represents a MailItem object.




Data Type





(Not used in VBScript). False when the event occurs. If the event procedure sets this argument to True, the close operation is not completed and the inspector is left open.

In Microsoft Visual Basic Scripting Edition (VBScript), if you set the return value of this function to False, the close operation isn't completed and the inspector is left open.

If you use the Close method to fire this event, it can only be canceled if the Close method uses the olPromptForSave argument.

This Microsoft Visual Basic for Applications (VBA) example tests for the Close event and if the item has not been Saved, it uses the Save method to save the item without prompting the user.

Public WithEvents myItem As Outlook.MailItem 
Public Sub Initalize_Handler() 
 Set myItem = Application.ActiveInspector.CurrentItem 
End Sub 
Private Sub myItem_Close(Cancel As Boolean) 
 If Not myItem.Saved Then 
 MsgBox " The item was saved." 
 End If 
End Sub