Edit

MailItem.Close event (Outlook)

  • Article

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

Syntax

expression.Close (Cancel)

expression A variable that represents a MailItem object.

Parameters

Name Required/Optional Data type Description
Cancel Required Boolean (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.

Remarks

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.

Example

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 Initialize_Handler() 
 
 Set myItem = Application.ActiveInspector.CurrentItem 
 
End Sub 
 
 
 
Private Sub myItem_Close(Cancel As Boolean) 
 
 If Not myItem.Saved Then 
 
 myItem.Save 
 
 MsgBox " The item was saved." 
 
 End If 
 
End Sub

See also

MailItem Object

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.