Explorer.BeforeItemCopy 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 an Outlook item is copied.

expression .BeforeItemCopy(Cancel)

expression A variable that represents an Explorer object.




Data Type





False when the event occurs. If the event procedure sets this argument to True, the operation is not completed and the item is not copied.

This event can be cancelled after it has started.

The following Microsoft Visual Basic for Applications (VBA) example prompts the user before an item is copied. A message is displayed to the user verifying that the item should be copied. If the user clicks Yes, the item is copied to the Clipboard. The sample code must be placed in a class module such as ThisOutlookSession, and the Initialize_handler routine must be called before the event procedure can be called by Microsoft Outlook.

Public WithEvents myOlExp As Outlook.Explorer 
Sub Initalize_Handler() 
Set myOlExp = Application.ActiveExplorer 
End Sub 
Private Sub myOlExp_BeforeItemCopy(Cancel As Boolean) 
'Prompts the user before copying an item 
 Dim lngAns As Long 'user answer 
 'Display question to user 
 lngAns = MsgBox("Are you sure you want to copy the item?", vbYesNo) 
 If lngAns = vbYes Then 
 Cancel = False 
 'Set Cancel argument based on answer 
 Cancel = True 
 End If 
End Sub