CMFCOutlookBarTabCtrl 類別

具有 Microsoft Outlook [ 巡覽窗格 ] 視覺外觀的索引標籤控制項。 如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。

語法

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

成員

公用建構函式

名稱	描述
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl	預設建構函式。
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl	解構函式。

公用方法

名稱	描述
CMFCOutlookBarTabCtrl：：AddControl	將 Windows 控件新增為 Outlook 列中的新索引標籤。
CMFCOutlookBarTabCtrl::CalcRectEdit	由架構呼叫，以判斷使用者重新命名索引標籤時所出現的編輯方塊維度。（覆寫 CMFCBaseTabCtrl::CalcRectEdit。）
CMFCOutlookBarTabCtrl：：CanShowFewerPageButtons	調整作業期間由架構呼叫，以判斷是否可以顯示少於目前可見的 Outlook 列索引標籤面按鈕。
CMFCOutlookBarTabCtrl：：CanShowMorePageButtons	調整作業期間由架構呼叫，以判斷是否可以顯示更多 Outlook 列索引標籤面按鈕，而不是目前可見。
CMFCOutlookBarTabCtrl：：Create	建立 Outlook 列索引標籤件。
CMFCOutlookBarTabCtrl::CreateObject	由建立此類別類型的動態執行個體架構所使用。
CMFCOutlookBarTabCtrl：：EnableAnimation	指定是否啟用作用中索引標籤之間切換期間發生的動畫。
CMFCOutlookBarTabCtrl：：EnableInPlaceEdit	指定使用者是否可以在 Outlook 列的索引標籤按鈕上修改文字標籤。 （覆寫 CMFCBaseTabCtrl：：EnableInPlaceEdit.）
CMFCOutlookBarTabCtrl：：EnableScrollButtons	由架構呼叫，以啟用按鈕，讓使用者在 Outlook 列窗格上捲動按鈕。
CMFCOutlookBarTabCtrl::FindTargetWnd	識別包含指定點的窗格。 （覆寫 CMFCBaseTabCtrl：：FindTargetWnd.）
CMFCOutlookBarTabCtrl：：GetBorderSize	傳回 Outlook 索引標籤的框線大小。
CMFCOutlookBarTabCtrl::GetTabArea	擷取定位點控制項之定位點區域的大小和位置。 （覆寫 CMFCBaseTabCtrl：：GetTabArea.）
CMFCOutlookBarTabCtrl::GetThisClass	由架構用來取得與這個類別類型相關聯之 CRuntimeClass 物件的指標。
CMFCOutlookBarTabCtrl：：GetVisiblePageButtons
CMFCOutlookBarTabCtrl：：IsAnimation	判斷是否啟用作用中索引標籤之間切換期間發生的動畫。
CMFCOutlookBarTabCtrl：：IsMode2003	判斷 Outlook 列索引卷標控件是否處於模擬 Outlook 2003 Microsoft模式。
CMFCOutlookBarTabCtrl::IsPtInTabArea	判斷點是否在定位點區域內。 （覆寫 CMFCBaseTabCtrl：：IsPtInTabArea.）
CMFCOutlookBarTabCtrl::IsTabDetachable	指出是否可以中斷連結定位點。 （覆寫 CMFCBaseTabCtrl：：IsTabDetachable.）
CMFCOutlookBarTabCtrl::OnChangeTabs	插入或移除索引標籤時，由架構呼叫。 (覆寫 CMFCBaseTabCtrl::OnChangeTabs。)
CMFCOutlookBarTabCtrl：：OnShowFewerPageButtons	由架構呼叫，以減少可見的索引標籤按鈕數目。
CMFCOutlookBarTabCtrl：：OnShowMorePageButtons	由架構呼叫，以增加可見的索引標籤按鈕數目。
CMFCOutlookBarTabCtrl：：OnShowOptions	顯示 [ 導航窗格選項 ] 對話框。
CMFCOutlookBarTabCtrl::RecalcLayout	重新計算定位點控制項的內部配置。 （覆寫 CMFCBaseTabCtrl：：RecalcLayout.）
CMFCOutlookBarTabCtrl：：SetActiveTab	設定使用中的索引標籤。（覆寫 CMFCBaseTabCtrl：：SetActiveTab.）
CMFCOutlookBarTabCtrl：：SetBorderSize	設定 Outlook 索引標籤元件的框線大小。
CMFCOutlookBarTabCtrl：：SetPageButtonTextAlign	設定 Outlook 列索引標籤上索引標籤的對齊方式。
CMFCOutlookBarTabCtrl：：SetToolbarImageList	設定位圖，其中包含 Outlook 2003 模式 Outlook 列底部顯示的圖示（請參閱 CMFCOutlookBar 類別）。
CMFCOutlookBarTabCtrl：：SetVisiblePageButtons

備註

若要建立具有停駐支援的 Outlook 列，請使用 CMFCOutlookBar 對象來裝載 Outlook 列索引標籤控制件。 如需詳細資訊，請參閱 CMFCOutlookBar類別。

範例

下列範例示範如何初始化 CMFCOutlookBarTabCtrl 物件，並在類別中使用 CMFCOutlookBarTabCtrl 各種方法。 此範例示範如何在 Outlook 列的索引標籤面上啟用文字標籤就地編輯、啟用動畫、啟用捲動控點，讓使用者在 Outlook 列窗格上捲動按鈕、設定 Outlook 索引卷標控件的框線大小，以及在 Outlook 列的索引標籤上設定文字捲標的對齊方式。 此代碼段是 Outlook 示範範例的一部分。

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

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

繼承階層架構

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

需求

標頭： afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl：：AddControl

將 Windows 控件新增為 Outlook 列中的新索引標籤。

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

參數

pWndCtrl
[in]要加入之控件的指標。

lpszName
[in]指定索引標籤的名稱。

bDetachable
[in]如果為 TRUE，則會將頁面建立為可卸離。

nImageID
[in]要顯示在新索引標籤中之影像的內部影像清單中的影像索引。

dwControlBarStyle
[in]指定包裝停駐窗格的AFX_ CBRS_* 樣式。

備註

使用此函式將控件新增為 Outlook 列的新頁面。

此函式會在內部呼叫 CMFCBaseTabCtrl：：AddTab。

如果您將 bDetachable 設定為 TRUE，AddControl請在內部建立 CDockablePaneAdapter 物件並包裝新增的控件。 它會自動將索引標籤視窗的執行時間類別設定為的 CMFCOutlookBar 執行時間類別，並將浮動框架的執行時間類別設定為 CMultiPaneFrameWnd。

範例

下列範例示範如何在 類別中使用 AddControl CMFCOutlookBarTabCtrl 方法。 此代碼段是 Outlook 示範範例的一部分。

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl：：CanShowFewerPageButtons

在重設大小作業期間由架構呼叫，以判斷是否可以顯示比目前可見的要少的 Outlook 列索引標籤面按鈕。

virtual BOOL CanShowFewerPageButtons() const;

傳回值

如果有多個按鈕，則為TRUE;否則為 FALSE。

備註

Outlook 列索引標籤機會根據可用的空間量，動態新增或移除顯示器中的索引標籤。 架構會使用此方法來協助該程式。

CMFCOutlookBarTabCtrl：：CanShowMorePageButtons

在重設大小作業期間由架構呼叫，以判斷是否可以顯示更多 Outlook 列索引卷標頁面按鈕，而不是目前可見。

virtual BOOL CanShowMorePageButtons() const;

傳回值

如果目前看不到按鈕，則為TRUE;否則為 FALSE。

備註

Outlook 列索引標籤機會根據可用的空間量，動態新增或移除顯示器中的索引標籤。 架構會使用此方法來協助該程式。

CMFCOutlookBarTabCtrl：：Create

建立 Outlook 列索引標籤件。

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

參數

rect
[in]指定初始大小和位置，以像素為單位。

pParentWnd
[in]指向父視窗。 不得為 NULL。

nID
[in]控件識別碼。

傳回值

如果控件已成功建立，則為非零;否則為 0。

備註

通常，當 CMFCOutlookBar 類別控制程式的WM_CREATE訊息時，就會建立 outlook 列索引標籤控制件。

CMFCOutlookBarTabCtrl：：EnableAnimation

指定是否啟用作用中索引標籤之間切換期間發生的動畫。

static void EnableAnimation(BOOL bEnable=TRUE);

參數

bEnable
[in]指定是否應該啟用或停用動畫。

備註

呼叫此函式以啟用和停用動畫。 當使用者開啟索引標籤面時，如果啟用動畫，頁面的標題會向上或向下滑動。 如果停用動畫，頁面會立即變成使用中。

根據預設，會啟用動畫。

CMFCOutlookBarTabCtrl：：EnableInPlaceEdit

指定使用者是否可以修改 Outlook 列的索引標籤面按鈕上的文字標籤。

virtual void EnableInPlaceEdit(BOOL bEnable);

參數

bEnable
如果為 TRUE，請啟用文字標籤的就地編輯。 如果為 FALSE，請停用就地編輯。

備註

呼叫此函式，以在索引標籤面按鈕上啟用或停用文字標籤的就地編輯。 預設會停用就地編輯。

CMFCOutlookBarTabCtrl：：EnableScrollButtons

由架構呼叫，以啟用捲動句柄，讓使用者在 Outlook 列窗格上捲動按鈕。

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

參數

bEnable
[in]判斷是否顯示卷動按鈕。

bIsUp
[in]判斷上方滾動條是否顯示。

bIsDown
[in]判斷是否顯示底部滾動條。

備註

啟用捲動按鈕的顯示。 當使用中索引標籤變更以還原卷動按鈕時，架構會呼叫此方法。

CMFCOutlookBarTabCtrl：：GetBorderSize

傳回 Outlook 索引標籤的框線大小。

int GetBorderSize() const;

傳回值

框線大小，以像素為單位。

CMFCOutlookBarTabCtrl：：GetVisiblePageButtons

int GetVisiblePageButtons() const;

傳回值

備註

CMFCOutlookBarTabCtrl：：IsAnimation

指定是否啟用作用中索引標籤之間切換期間發生的動畫。

static BOOL IsAnimation();

傳回值

如果啟用動畫，則為非零;否則為 0。

備註

呼叫 CMFCOutlookBarTabCtrl：：EnableAnimation 函式來啟用或停用動畫。

CMFCOutlookBarTabCtrl：：IsMode2003

判斷 Outlook 列索引卷標控件是否處於模擬 Microsoft Outlook 2003 的模式。

BOOL IsMode2003() const;

傳回值

如果 Outlook 列索引標籤的控件處於 Outlook 2003 模式，則為 TRUE;否則為 FALSE;

備註

這個值是由 CMFCOutlookBar：：SetMode2003 所設定。

CMFCOutlookBarTabCtrl：：OnShowFewerPageButtons

由架構呼叫，以減少可見的索引標籤按鈕數目。

virtual void OnShowFewerPageButtons();

備註

這個方法會調整控件重設大小時的可見頁面索引標籤按鈕數目。

CMFCOutlookBarTabCtrl：：OnShowMorePageButtons

由架構呼叫，以增加可見的索引標籤按鈕數目。

virtual void OnShowMorePageButtons();

備註

這個方法會調整控件重設大小時可見的索引標籤按鈕數目。

CMFCOutlookBarTabCtrl：：OnShowOptions

顯示 [ 導航窗格選項 ] 對話框。

virtual void OnShowOptions();

備註

[ 導航窗格選項 ] 對話框可讓使用者選取要顯示的索引卷標頁面按鈕，以及顯示它們的順序。

當使用者從控件的自定義功能表選取 導航窗格選項 功能表項時，架構會呼叫此方法。

CMFCOutlookBarTabCtrl：：SetActiveTab

設定使用中的索引標籤。使用中索引標籤是開啟的索引標籤，其內容會顯示。

virtual BOOL SetActiveTab(int iTab);

參數

iTab
[in]要開啟之索引標籤之以零起始的索引。

傳回值

如果已成功開啟指定的索引標籤，則為非零;否則為 0。

備註

設定使用中索引標籤的視覺效果取決於您是否已啟用動畫。 如需詳細資訊，請參閱 CMFCOutlookBarTabCtrl：：EnableAnimation。

CMFCOutlookBarTabCtrl：：SetBorderSize

設定 Outlook 索引標籤元件的框線大小。

void SetBorderSize(int nBorderSize);

參數

nBorderSize
[in]指定以像素為單位的新框線大小。

備註

設定新的框線大小，並重新計算 Outlook 視窗版面配置。

CMFCOutlookBarTabCtrl：：SetPageButtonTextAlign

設定 Outlook 列索引標籤上索引標籤的對齊方式。

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

參數

uiAlign
[in]指定文字對齊方式。

bRedraw
[in]如果為TRUE，則會重新繪製 Outlook 視窗。

備註

使用此函式來變更頁面按鈕的文字對齊方式。

uiAlign 可以是下列其中一個值：

常數	意義
TA_LEFT	靠左對齊
TA_CENTER	置中對齊
TA_RIGHT	靠右對齊

預設值為 TA_CENTER。

CMFCOutlookBarTabCtrl：：SetToolbarImageList

設定位圖，其中包含 Outlook 2003 模式 Outlook 列底部顯示的圖示。

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

參數

uiID
[in]指定要載入之映像的資源識別碼。

cx
[in]指定影像清單中的影像寬度，以像素為單位。

clrTransp
[in]指定透明色彩的 RGB 值。

傳回值

如果成功，則傳回 TRUE;否則會傳回 FALSE。

備註

使用此函式來附加影像清單，其影像將在 Microsoft office 2003 模式的工具列按鈕上顯示。 影像索引應對應至頁面索引。

如果不是在 Microsoft Office 2003 模式中，就不應該呼叫這個方法。 如需詳細資訊，請參閱 CMFCOutlookBar類別。

CMFCOutlookBarTabCtrl：：SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

參數

[in] nVisiblePageButtons

備註

另請參閱

階層架構圖表
類別
CMFCBaseTabCtrl 類別
CMFCOutlookBar 類別
CMFCOutlookBarPane 類別