CMFCOutlookBarTabCtrl Class

Article
01/30/2013

A tab control that has the visual appearance of the Navigation Pane in Microsoft Outlook.

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Members

Public Constructors

Name	Description
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl	Default constructor.
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl	Destructor.

Public Methods

Name	Description
CMFCOutlookBarTabCtrl::AddControl	Adds a Windows control as a new tab in the Outlook bar.
CMFCOutlookBarTabCtrl::CalcRectEdit	Called by the framework to determine the dimensions of the edit box that appears when a user renames a tab. (Overrides CMFCBaseTabCtrl::CalcRectEdit.)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons	Called by the framework during resizing operations to determine if fewer Outlook bar tab page buttons can be displayed than are currently visible.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons	Called by the framework during resizing operations to determine if more Outlook bar tab page buttons can be displayed than are currently visible.
CMFCOutlookBarTabCtrl::Create	Creates the Outlook bar tab control.
CMFCOutlookBarTabCtrl::CreateObject	Used by the framework to create a dynamic instance of this class type.
CMFCOutlookBarTabCtrl::EnableAnimation	Specifies whether the animation that occurs during the switch between active tabs is enabled.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit	Specifies whether a user can modify the text labels on the tab buttons of the Outlook bar. (Overrides CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons	Called by the framework to enable buttons that allow the user to scroll through buttons on the Outlook bar pane.
CMFCOutlookBarTabCtrl::FindTargetWnd	Identifies the pane that contains a specified point. (Overrides CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize	Returns the border size of the Outlook tab control.
CMFCOutlookBarTabCtrl::GetTabArea	Retrieves the size and position of the tab area of the tab control. (Overrides CMFCBaseTabCtrl::GetTabArea.)
CMFCOutlookBarTabCtrl::GetThisClass	Used by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation	Determines whether the animation that occurs during the switch between active tabs is enabled.
CMFCOutlookBarTabCtrl::IsMode2003	Determines if the Outlook bar tab control is in a mode that emulates Microsoft Outlook 2003.
CMFCOutlookBarTabCtrl::IsPtInTabArea	Determines if a point is inside the tab area. (Overrides CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCOutlookBarTabCtrl::IsTabDetachable	Determines whether a tab is detachable. (Overrides CMFCBaseTabCtrl::IsTabDetachable.)
CMFCOutlookBarTabCtrl::OnChangeTabs	Called by the framework when a tab is inserted or removed. (Overrides CMFCBaseTabCtrl::OnChangeTabs.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons	Called by the framework to decrease the number of tab page buttons that are visible.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons	Called by the framework to increase the number of tab page buttons that are visible.
CMFCOutlookBarTabCtrl::OnShowOptions	Displays the Navigation Pane Options dialog.
CMFCOutlookBarTabCtrl::RecalcLayout	Recalculates the internal layout of the tab control. (Overrides CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab	Sets the active tab. (Overrides CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize	Sets the border size of the Outlook tab control.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign	Sets the alignment of the text labels on the tab buttons of the Outlook bar.
CMFCOutlookBarTabCtrl::SetToolbarImageList	Sets the bitmap that contains the icons that are displayed on the bottom of the Outlook bar in Outlook 2003 mode (see CMFCOutlookBar Class).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Remarks

To create an Outlook bar that has docking support, use a CMFCOutlookBar object to host the Outlook bar tab control. For more information, see CMFCOutlookBar Class.

Example

The following example demonstrates how to initialize a CMFCOutlookBarTabCtrl object and use various methods in the CMFCOutlookBarTabCtrl class. The example shows how to enable the in-place editing of the text label on the tab page buttons of the Outlook bar, enable the animation, enable scroll handles that enable the user to scroll through buttons on the Outlook bar pane, set the border size of the Outlook tab control, and set the alignment of the text labels on the tab buttons of the Outlook bar. This code snippet is part of the Outlook Demo sample.

    // CMFCOutlookBar& bar
    CMFCOutlookBarTabCtrl* pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();


...


    pOutlookBar->EnableInPlaceEdit(TRUE);
    pOutlookBar->EnableAnimation();
    pOutlookBar->EnableScrollButtons();
    pOutlookBar->SetBorderSize(10);
    pOutlookBar->SetPageButtonTextAlign(TA_LEFT);