Custom task panes for Microsoft Office
Word, PowerPoint, Outlook, Excel in VB.NET, C#

Add-in Express™
for Microsoft® Office and .net

Add-in Express Home > Add-in Express for Office and .NET > Online Guide > Add-in Express components > Introduction into advanced Outlook regions and advanced Office task panes

Introduction into advanced Outlook regions and advanced task panes

Add-in Express allows creating advanced Outlook regions for Outlook, versions 2000 - 2010, and advanced Office task panes for Excel, Word and PowerPoint, versions 2000 - 2010.

An absolute must-know

Here are the three main points you should be aware of:

  • There are application-specific <Manager> components such as ADXOlFormsManager or ADXEcelTaskPanesManager; every <Manager> component provides the Items collection; each <Item> from the collection binds a <Form>, which is an application-specific descendant of System.Windows.Forms.Form such as ADXOlForm or ADXExcelTaskPane, to the visualization (Excel, Word, PowerPoint and Outlook) and context (Outlook- only) settings.
  • You never create an instance of a <Form> in the way you create an instance of System.Windows.Forms.Form; instead, the <Manager> creates instances of the <Form> for you; the instances are created either automatically or at your request.
  • The Visible property of a <Form> instance is true, when the instance is embedded into a sub-pane of the host window (as specified by the visualization settings) regardless of the actual visibility of the instance; the Active property of the <Form> instance is true, when the instance is actually shown on top of all other instances in the same region.

Note. Anywhere on this page, as well as on other pages, a term in angle brackets, such as <Manager> or <Form> above, specifies a component, class, or class member, the actual name of which is application-dependent. Every such term is covered on the corresponding page of this manual.

Advanced task panes for Word, Excel and PowerPoint

In Add-in Express terms, an advanced Office task pane is a sub-pane, or a dock, of the main Excel, Word or PowerPoint window that may host native .NET forms. The screenshot below shows a sample task pane embedded into all available Excel docks.

Custom task panes in 4 regions

Advanced Outlook form and view regions

In Add-in Express terms, an advanced Outlook region is a sub-pane, or a dock, of Outlook windows that may host native .NET forms. There are two types of the advanced regions - Outlook view regions (sub-panes on the Outlook Explorer window) and Outlook form regions (sub-panes of the Outlook Inspector window).

Outlook view regions are specified in the ExplorerLayout property of the item (= ADXOlFormsCollectionItem). Outlook form regions are specified in the InspectorLayout property of the item. That is, one ADXOlFormsCollectionItem may show your form in a view and form region. Note that you must also specify the item's ExplorerItemTypes and/or InspectorItemTypes properties; otherwise, the form (an instance of ADXOlForm) will never be shown.

Outlook view regions:

  • Four regions around the list of mails, tasks, contacts etc. The region names are LeftSubpane, TopSubpane, RightSubpane, BottomSubpane (see the screenshot below). A restriction: those regions are not available for Calendar folders in Outlook 2010.
  • One region below the Navigation Pane - BottomNavigationPane (see the screenshot below)
  • One region below the To-Do Bar - BottomTodoBar (see the screenshot below)

Advanced regions regions below the Navigation Pane and To-Do Bar

  • Four regions around the Explorer window (Outlook 2007-2010) - DockLeft, DockTop, DockRight, DockBottom (see the screenshot below). The restrictions of these regions are:
    • The Hidden and Minimized region states are not supported for docked regions
    • Docked regions are not available for pre-2007 versions of Outlook
    • Docked panes have limitations on minimal height or width

    Four regions around the Explorer window

    • Four regions around the Reading Pane - LeftReadingPane, TopReadingPane, RightReadingPane, BottomReadingPane:

    Four regions around the Reading Pane

    • The WebViewPane region. Note that it uses Outlook properties in order to replace the items grid with your form (see also WebViewPane).

    The WebViewPane region

    • The FolderView region. Unlike WebViewPane, it allows the user to switch between the original Outlook view and your form. A restriction: those regions are not available for Calendar folders in Outlook 2010.

    The FolderView region

    • The ReadingPane region:

    The ReadingPane region

    Outlook form regions:

    • Four regions around the body of an e-mail, task, contact, etc. The region names are LeftSubpane, TopSubpane, RightSubpane, BottomSubpane:

    Four regions around the body of an e-mail, task, contact, etc

    • The InspectorRegion region (see the two screenshots below) allows switching between your form and the Outlook inspector pane.

    The InspectorRegion region

    The InspectorRegion region

    Custom task panes in Office 2007 - 2010 <<

    >> UI mechanics for advanced Outlook regions and advanced Office task panes

    Back to Add-in Express for Office and .NET homepage