More Outlook Resource Sites

Microsoft Developer Network (MSDN)

FAQs and other general resources

Using the Outlook View Control

The Outlook View Control (OVC) is an ActiveX control that automatically installs with Outlook. It can display the contents of an Outlook folder in an Outlook custom form, folder home page, or add-in. It also has some limited usefulness for displaying Outlook data in a web page or other external application.

Usage

Basic implementation information is available at:

You must set the Folder parameter for the OVC or it will appear blank. The Folder parameter is language-dependent. It need the name of the folder or path as seen in the user's Folder List (and returned by the FolderPath property).

If you are using the OVC in a web page or other non-Outlook application, omit the View parameter (e.g. <param name="View" value="By Category">) in the initial settings for the control. If you set the View this way, even to value="", more often than not it will cause the control to default to the user's Inbox rather than showing the folder you want. See Outlook View Control View Issue Demo for a demonstration of this issue.

To show only certain items in the OVC, use either the Restriction property, which takes the same query syntax as the Items.Find and Items.Restrict methods, or the Filter property, which takes a DASL query.

Limitations

The OVC can show only one folder at a time. It cannot duplicate the multi-folder list of items that Outlook shows on the Activities tab of a contact form.

Access to the OutlookApplication property, which returns an Outlook.Application object, is blocked unless the OVC is running in an Outlook context (such as a custom form or folder home page).

Known Issues

Don't use DeferUpdate if you're also planning to apply a Restriction. See the discussion at OVC Restriction Only Functions After Filter.

The OVC cannot be used as a control on an Access 2007 user form.

Also see:

Samples

More Information