Explorer.BeforeFolderSwitch Event (Outlook)
Published: July 16, 2012
Occurs before the explorer goes to a new folder, either as a result of user action or through program code.
expression .BeforeFolderSwitch(NewFolder, Cancel)
expression A variable that represents an Explorer object.
Parameters
|
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
|
NewFolder |
Required |
Object |
The Folder object the explorer is switching to. |
|
Cancel |
Required |
Boolean |
False when the event occurs. If the event procedure sets this argument to True, navigation is cancelled, and the current folder is not changed. |
This sample prevents a user from switching to a folder named "Off Limits". 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. To run this example without errors, make sure a folder by the name 'Off Limits' exists in the folder displayed in the active explorer.
Public WithEvents myOlExp As Outlook.Explorer Public Sub Initialize_handler() Set myOlExp = Application.ActiveExplorer End Sub Private Sub myOlExp_BeforeFolderSwitch(ByVal NewFolder As Object, Cancel As Boolean) If NewFolder.Name = "Off Limits" Then MsgBox "You do not have permission to access this folder." Cancel = True End If End Sub