Export (0) Print
Expand All

Folder.GetExplorer Method

Office 2007
Returns an Explorer object that represents a new, inactive Explorer object initialized with the specified folder as the current folder.

Version Information
 Version Added:  Outlook 2007

Syntax

expression.GetExplorer(DisplayMode)

expression   A variable that represents a Folder object.

Parameters

NameRequired/OptionalData TypeDescription
DisplayModeOptionalVariantThe display mode of the folder. Can be one of the constants in the OlFolderDisplayMode enumeration.

Return Value
An Explorer object that represents a new, inactive Explorer initialized with the specified folder as the current folder.

Remarks

This method is useful for returning a new Explorer object in which to display the folder, as opposed to using the ActiveExplorer method and setting the CurrentFolder property.

The Explorer.Display method can be used to activate or show the Explorer.

The GetExplorer method takes an optional argument of an OlFolderDisplayMode constant.

By default, the new Explorer will be displayed in the Normal mode (olFolderDisplayNormal) with all interface elements displayed: a message panel on the right and the Navigation Pane on the left. The exception to this rule is when you are calling GetExplorer on delegated folders that are in No-Navigation mode (olFolderDisplayNoNavigation ) by default. You can apply more restrictions to a default mode, but you cannot lessen the restrictions by changing the OlFolderDisplayMode.

The explorer can also be displayed in Folder-Only mode (olFolderDisplayFolderOnly). This mode is essentially the same as the Normal mode (olFolderDisplayNormal ) in that it too displays the Navigation Pane on the left.

The most restrictive mode you can use is No-Navigation mode (olFolderDisplayNoNavigation). In this mode, the Explorer will display with no folder list, no drop-down folder list, and any "Go"-type menu/command bar options should be disabled. Basically, the user should not be able to navigate to any other folder within that Explorer window. By default, a delegated (shared) folder appears in No-Navigation mode.

Example

This Visual Basic for Applications (VBA) example uses the GetExplorer method to return a new, inactive Explorer for the default Contacts folder, disables the user from customizing the commandbars, and then displays it in the default mode of olFolderDisplayNormal. Once the subroutine is run, the user will not be able to add or remove toolbar buttons or customize the menu options.

Visual Basic for Applications
Sub DisableCustomize()
    Dim nsp As Outlook.NameSpace
    Dim mpfContacts As Outlook.Folder
    Dim expContacts As Outlook.Explorer

    Set nsp = Application.GetNamespace("MAPI")
    Set mpfContacts = nsp.GetDefaultFolder(olFolderContacts)
    Set expContacts = mpfContacts.GetExplorer
    expContacts.CommandBars.DisableCustomize = True
    expContacts.Activate
End Sub



Community Additions

ADD
Show:
© 2014 Microsoft