CMFCOutlookBar选件类

项目
03/13/2013

具有 导航窗格 的可视外观的一个选项卡式窗格 Microsoft Outlook 2000 或 Outlook 2003)。CMFCOutlookBar 对象包含一个 CMFCOutlookBarTabCtrl选件类对象和一系列选项。选项可以是 CMFCOutlookBarPane选件类对象或 CWnd派生的对象。给用户，Outlook 栏显示为一系列按钮和显示区域。当用户单击按钮时，相应的控件或按钮窗格中显示。

class CMFCOutlookBar : public CBaseTabbedPane

成员

公共构造函数

名称	描述
CMFCOutlookBar::CMFCOutlookBar	默认构造函数。
CMFCOutlookBar::~CMFCOutlookBar	析构函数。

公共方法

名称	描述
CMFCOutlookBar::AllowDestroyEmptyTabbedPane	指定是否可以销毁一个空选项卡式窗格。(重写 CBaseTabbedPane::AllowDestroyEmptyTabbedPane。)
CMFCOutlookBar::CanAcceptPane	确定另一个窗格是否可以停靠到 Outlook 栏窗格。(重写 CDockablePane::CanAcceptPane。)
CMFCOutlookBar::CanSetCaptionTextToTabName	确定选项卡式窗格的声明是否显示文本的并且有效选项相同。(重写 CBaseTabbedPane::CanSetCaptionTextToTabName。)
CMFCOutlookBar::Create	创建 Outlook 栏控件。
CMFCOutlookBar::CreateCustomPage	创建自定义 Outlook 栏选项。
CMFCOutlookBar::CreateObject	用于由框架创建此选件类类型动态实例。
CMFCOutlookBar::DoesAllowDynInsertBefore	确定用户是否可以将控件停靠栏位于 Outlook 栏的外边缘。
CMFCOutlookBar::FloatTab	只有 + 当窗格当前位于一个可拆的选项，浮动窗格中，但。(重写 CBaseTabbedPane::FloatTab。)
CMFCOutlookBar::GetButtonsFont	返回文本的字体在 Outlook 栏按钮的。
CMFCOutlookBar::GetTabArea	返回选项区域的大小和位置在 Outlook 栏。(重写 CBaseTabbedPane::GetTabArea。)
CMFCOutlookBar::GetThisClass	用于由框架获取指向与此选件类类型的 CRuntimeClass 对象。
CMFCOutlookBar::IsMode2003	确定是否 Microsoft Office Outlook 2003 Outlook 栏类似于的行为 (请参见"备注")。
CMFCOutlookBar::OnAfterAnimation	使用动画，调用 CMFCOutlookBarTabCtrl::SetActiveTab 在活动选项后设置。
CMFCOutlookBar::OnBeforeAnimation	使用动画，调用 CMFCOutlookBarTabCtrl::SetActiveTab 在选项卡页之前设置为有效的选项。
CMFCOutlookBar::OnScroll	调用由框架，如果 Outlook 栏上移或下移。
CMFCOutlookBar::RemoveCustomPage	移除自定义 Outlook 栏选项。
CMFCOutlookBar::SetButtonsFont	设置文本的字体在 Outlook 栏按钮的。
CMFCOutlookBar::SetMode2003	指定是否 Outlook 2003 Outlook 栏类似于的行为 (请参见"备注")。

备注

有关 Outlook 栏的示例，请参见 OutlookDemo 示例：MFC OutlookDemo 应用程序。

实现 Outlook 栏

若要使用 CMFCOutlookBar 控件在您的应用程序，请执行以下步骤：

嵌入一 CMFCOutlookBar 对象向主框架窗口选件类。

class CMainFrame : public CMDIFrameWnd
 { ...
     CMFCOutlookBar         m_wndOutlookBar;
     CMFCOutlookBarPane     m_wndOutlookPane;
... };

在处理在主框架中的 WM_CREATE 消息，请调用 CMFCOutlookBar::Create 方法创建 Outlook 栏选项卡控件。

m_wndOutlookBar.Create (_T("Shortcuts"), this, CRect (0, 0, 100, 100), ID_VIEW_OUTLOOKBAR, WS_CHILD | WS_VISIBLE | CBRS_LEFT);

使用 CBaseTabbedPane::GetUnderlyingWindow，获取指向基础 CMFCOutlookBarTabCtrl。

CMFCOutlookBarTabCtrl* pOutlookBar = (CMFCOutlookBarTabCtrl*) m_wndOutlookBar.GetUnderlyingWindow ();

创建包含按钮的每个选项卡的 CMFCOutlookBarPane选件类对象。

m_wndOutlookPane.Create (&m_wndOutlookBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_OUTLOOK_PANE_GENERAL, AFX_CBRS_FLOAT | AFX_CBRS_RESIZE);
// make the Outlook pane detachable (enable docking)
m_wndOutlookPane.EnableDocking (CBRS_ALIGN_ANY);
// add buttons
m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_MAINFRAME), "About", ID_APP_ABOUT);
m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_CUSTOM_OPEN_ICON), "Open", ID_FILE_OPEN);

调用 CMFCBaseTabCtrl::AddTab 添加每个新选项。设置 bDetachable 参数传递给 FALSE 使页非可拆。或者，使用 CMFCOutlookBarTabCtrl::AddControl 添加可拆的页。
```
pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE); 
```
若要添加 CWnd派生的控件 (例如，CMFCShellTreeCtrl选件类) 作为选项卡上，创建控件并调用 CMFCBaseTabCtrl::AddTab 添加到 Outlook 栏。