`CMFCTabCtrl` 類別

發行項
07/05/2024

類別 CMFCTabCtrl 提供選項卡控件的功能。索引標籤控制項會顯示頂端或底部有一般或 3D 索引標籤的可停駐視窗。索引標籤可以顯示文字和影像，當在使用中狀態時，也可變更色彩。

語法

class CMFCTabCtrl : public CMFCBaseTabCtrl

成員

公用建構函式

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

公用方法

名稱	描述
`CMFCTabCtrl::ActivateMDITab`	顯示目前索引標籤控件的指定索引標籤，並將焦點設定在該索引標籤上。
`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`
`CMFCTabCtrl::AutoSizeWindow`	指定當選項卡控件的使用者介面元素變更時，架構是否要調整所有索引標籤視窗的工作區大小。
`CMFCTabCtrl::CalcRectEdit`	解構指定之索引標籤區域的大小。 (覆寫 `CMFCBaseTabCtrl::CalcRectEdit`)。
`CMFCTabCtrl::Create`	建立索引標籤控件，並將它附加至 `CMFCTabCtrl` 物件。
`CMFCTabCtrl::CreateObject`	由建立此類別類型的動態執行個體架構所使用。
`CMFCTabCtrl::EnableActiveTabCloseButton`	顯示或隱藏使用中索引標籤上的 [關閉] 按鈕（ X）。
`CMFCTabCtrl::EnableInPlaceEdit`	啟用或停用可編輯的索引標籤。 (覆寫 `CMFCBaseTabCtrl::EnableInPlaceEdit`。)
`CMFCTabCtrl::EnableTabDocumentsMenu`	將捲動視窗索引標籤的兩個按鈕取代為開啟索引標籤視窗選單的按鈕。
`CMFCTabCtrl::EnsureVisible`	確保索引標籤可見。
`CMFCTabCtrl::GetDocumentIcon`	擷取與索引標籤視窗彈出視窗中索引標籤相關聯的符號。
`CMFCTabCtrl::GetFirstVisibleTabNum`	擷取目前索引標籤中可見的第一個索引標籤。
`CMFCTabCtrl::GetResizeMode`	擷取值，指定如何調整目前索引標籤件的大小。
`CMFCTabCtrl::GetScrollBar`	擷取與選項卡控件相關聯的滾動條物件的指標。
`CMFCTabCtrl::GetTabArea`	擷取選項卡控件頂端或底部索引卷標區域的周框。 (覆寫 `CMFCBaseTabCtrl::GetTabArea`。)
`CMFCTabCtrl::GetTabFromPoint`	擷取包含指定點的定位點。 (覆寫 `CMFCBaseTabCtrl::GetTabFromPoint`。)
`CMFCTabCtrl::GetTabMaxWidth`	擷取索引標籤的最大寬度。
`CMFCTabCtrl::GetTabsHeight`	擷取目前索引標籤之索引標籤的高度。
`CMFCTabCtrl::GetTabsRect`	擷取矩形，這個矩形會系結目前選項卡控件的索引卷標區域。 (覆寫 `CMFCBaseTabCtrl::GetTabsRect`。)
`CMFCTabCtrl::GetThisClass`	由架構用來取得與這個類別類型相關聯之物件的指標 `CRuntimeClass` 。
`CMFCTabCtrl::GetWndArea`	擷取目前索引標籤之工作區的界限。
`CMFCTabCtrl::HideActiveWindowHorzScrollBar`	隱藏活動視窗的水準滾動條，如果有的話。
`CMFCTabCtrl::HideInactiveWindow`	指定架構是否要顯示非使用中的索引標籤視窗。
`CMFCTabCtrl::HideNoTabs`	如果沒有可見的索引標籤，啟用或停用繪製索引標籤區域。
`CMFCTabCtrl::HideSingleTab`	當有單一索引標籤視窗時，啟用或停用繪製索引標籤。 (覆寫 `CMFCBaseTabCtrl::HideSingleTab`。)
`CMFCTabCtrl::IsActiveInMDITabGroup`	指出選項卡控件的目前索引標籤是否為多個文檔介面索引標籤群組中的使用中索引標籤。
`CMFCTabCtrl::IsActiveTabBoldFont`	指出使用中索引標籤的文字是否使用粗體字型顯示。
`CMFCTabCtrl::IsActiveTabCloseButton`	指出 [關閉] 按鈕（ X）是否顯示在使用中的索引標籤或索引標籤區域的右上角。
`CMFCTabCtrl::IsDrawFrame`	指出索引卷標式視窗是否會在內嵌窗格周圍繪製框架矩形。
`CMFCTabCtrl::IsFlatFrame`	指出索引標籤區域周圍的框架是平面或 3D。
`CMFCTabCtrl::IsFlatTab`	指出目前索引標籤控件中索引標籤的外觀是否一般。
`CMFCTabCtrl::IsLeftRightRounded`	指出目前索引標籤控件中索引標籤左邊和右側的外觀是否四捨五入。
`CMFCTabCtrl::IsMDITabGroup`	指出目前索引標籤是否包含在多文檔介面視窗的工作區中。
`CMFCTabCtrl::IsOneNoteStyle`	指出目前的索引標籤控制項是否以 Microsoft OneNote 的樣式顯示。
`CMFCTabCtrl::IsPtInTabArea`	判斷點是否在定位點區域內。 (覆寫 `CMFCBaseTabCtrl::IsPtInTabArea`。)
`CMFCTabCtrl::IsSharedScroll`	指出目前的索引標籤控件是否有滾動條，可將其索引卷動為群組的索引標籤。
`CMFCTabCtrl::IsTabDocumentsMenu`	指出索引標籤控件是否顯示卷動按鈕，或顯示索引標籤視窗選單的按鈕。
`CMFCTabCtrl::IsVS2005Style`	指出索引標籤是否以 Visual Studio .NET 2005 的樣式顯示。
`CMFCTabCtrl::ModifyTabStyle`	指定目前索引標籤控件中索引標籤的外觀。
`CMFCTabCtrl::MoveTab`	將索引標籤移至另一個索引標籤位置。 (覆寫 `CMFCBaseTabCtrl::MoveTab`。)
`CMFCTabCtrl::OnDragEnter`	當游標第一次拖曳至索引標籤視窗時，由架構呼叫。
`CMFCTabCtrl::OnDragOver`	當滑鼠移到置放目標視窗上方時，架構會在拖曳作業期間由架構呼叫。 (覆寫 `CMFCBaseTabCtrl::OnDragOver`。)
`CMFCTabCtrl::OnShowTabDocumentsMenu`	顯示索引標籤視窗的快捷選單，等候使用者選取索引標籤，並將選取的索引標籤變成使用中索引標籤。
`CMFCTabCtrl::PreTranslateMessage`	在分派至 `TranslateMessage` 和 `DispatchMessage` Windows 函式之前，翻譯視窗訊息。 (覆寫 `CMFCBaseTabCtrl::PreTranslateMessage`。)
`CMFCTabCtrl::RecalcLayout`	重新計算定位點控制項的內部配置。 (覆寫 `CMFCBaseTabCtrl::RecalcLayout`。)
`CMFCTabCtrl::SetActiveInMDITabGroup`	將索引標籤的目前索引標籤設定為多個文件介面索引標籤群組中的使用中索引標籤。
`CMFCTabCtrl::SetActiveTab`	啟動索引標籤。（覆寫 `CMFCBaseTabCtrl::SetActiveTab`。）
`CMFCTabCtrl::SetActiveTabBoldFont`	啟用或停用使用中索引標籤上的粗體字型。
`CMFCTabCtrl::SetDrawFrame`	啟用或停用在內嵌列周圍繪製框架矩形。
`CMFCTabCtrl::SetFlatFrame`	指定在索引標籤區域周圍繪製平面或 3D 框架。
`CMFCTabCtrl::SetImageList`	指定影像清單。 (覆寫 `CMFCBaseTabCtrl::SetImageList`。)
`CMFCTabCtrl::SetResizeMode`	指定如何調整目前索引標籤的大小，然後重新顯示控制件。
`CMFCTabCtrl::SetTabMaxWidth`	指定索引標籤視窗中的索引標籤寬度上限。
`CMFCTabCtrl::StopResize`	終止索引標籤控件上目前的重設大小作業。
`CMFCTabCtrl::SwapTabs`	交換一組索引標籤。 (覆寫 `CMFCBaseTabCtrl::SwapTabs`。)
`CMFCTabCtrl::SynchronizeScrollBar`	在顯示一般索引標籤的索引標籤上繪製水平滾動條。

資料成員

名稱	描述
`CMFCTabCtrl::m_bEnableActivate`	當插入並啟用新的索引標籤時，防止使用中檢視失去焦點。

備註

類別 CMFCTabCtrl 支援：

包含 3D、平面和平面與共用水平滾動條的索引標籤控件樣式。
位於視窗頂端或底部的索引標籤。
顯示文字、影像或文字和影像的索引標籤。
索引標籤在使用中時變更色彩的索引標籤。
可調整索引標籤的框線大小變更。
可卸離索引標籤視窗。

類別 CMFCTabCtrl 可以搭配對話框使用，但適用於使用停駐控制列的應用程式，例如Microsoft Excel 和 Visual Studio。如需詳細資訊，請參閱 CDockablePane 類別。

請遵循下列步驟，在應用程式中新增可重設大小的停駐索引標籤控制項：

建立 Class 的CTabbedPane實例。
呼叫 CDockablePane::Create。
使用 CBaseTabbedPane::AddTab 或 CMFCBaseTabCtrl::InsertTab 新增索引標籤。
呼叫 CBasePane::EnableDocking ，讓目前的停駐索引標籤可以停駐在主框架視窗。
呼叫 CFrameWndEx::DockPane 以停駐主框架的索引標籤視窗。

如需如何建立索引標籤視窗做為停駐控件列的範例，請參閱 CTabbedPane 類別。若要使用 CMFCTabCtrl 做為非停駐控制件，請建立 CMFCTabCtrl 物件，然後呼叫 CMFCTabCtrl::Create。

繼承階層架構

範例

下列範例示範如何使用類別中的 CMFCTabCtrl 各種方法來設定 CMFCTabCtrl 物件。此範例說明如何新增索引標籤、顯示使用中索引標籤上的 [關閉] 按鈕、啟用可編輯的索引標籤，以及顯示索引卷標視窗卷標的快捷功能表。此範例是 State 集合範例的一部分。

CMFCTabCtrl m_wndTabs;

// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

需求

標頭： afxtabctrl.h

`CMFCTabCtrl::ActivateMDITab`

顯示目前索引標籤控件的指定索引標籤，並將焦點設定在該索引標籤上。

void ActivateMDITab(int nTab = -1);

參數

nTab
[in]要顯示的索引標籤以零起始，或 -1，以指定目前使用中的索引卷標。

`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`

如需詳細資訊，請參閱 Visual Studio 安裝位置下之 mfc 資料夾中的原始程式碼。例如： %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc 。

virtual BOOL AllowDestroyEmptyTabbedPane() const;

傳回值

一律為 TRUE。

備註

`CMFCTabCtrl::AutoSizeWindow`

指定當選項卡控件的使用者介面元素變更時，架構是否要調整所有索引標籤視窗的工作區大小。

void AutoSizeWindow(BOOL bAutoSize = TRUE);

參數

bAutoSize
[in] TRUE 表示自動調整索引標籤視窗的大小;否則為 FALSE。預設值是 TRUE。

備註

`CMFCTabCtrl::Create`

建立索引標籤控件，並將它附加至 CMFCTabCtrl 物件。

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

參數

style
[in]索引標籤控件的樣式。如需詳細資訊，請參閱＜備註＞。

rect
[in]系結製表元控件的矩形。

pParentWnd
[in]父視窗的指標。必須不是 NULL。

nID
[in]索引標籤控件的識別碼。

location
[in]索引標籤的位置。預設值是 LOCATION_BOTTOM。如需詳細資訊，請參閱備註。

bCloseBtn
[in] TRUE 表示在索引標籤上顯示關閉按鈕;否則為 FALSE。預設值是 FALSE。

傳回值

如果成功即為 TRUE；否則為 FALSE。

備註

下表描述您可以為 style 參數指定的值。

樣式	描述
`STYLE_3D`	建立具有三維外觀的索引標籤。
`STYLE_FLAT`	建立具有一般索引標籤的索引標籤控制項。
`STYLE_FLAT_SHARED_HORZ_SCROLL`	建立具有一般索引標籤和滾動條的索引標籤件，如果索引標籤是由父視窗裁剪，則可以捲動索引標籤。
`STYLE_3D_ONENOTE`	在 OneNote Microsoft 樣式中建立索引標籤控制件。
`STYLE_3D_VS2005`	在 Visual Studio 2005 Microsoft樣式中建立索引卷標控件。
`STYLE_3D_ROUNDED`	使用 Microsoft Visual Studio 2005 的樣式，建立具有四捨五入索引標籤的索引標籤元件。
`STYLE_3D_ROUNDED_SCROLL`	在 Visual Studio 2005 的樣式中，建立具有四捨五入索引標籤和捲動按鈕 Microsoft的索引卷標控件。

下表列出您可以為 location 參數指定的值。

Location	描述
`LOCATION_BOTTOM`	索引標籤位於索引標籤件的底部。
`LOCATION_TOP`	索引標籤位於索引標籤元件的頂端。

範例

下列範例示範如何在類別中使用 Create CMFCTabCtrl 方法。此範例是 State 集合範例的一部分。

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

`CMFCTabCtrl::CalcRectEdit`

解構指定之索引標籤區域的大小。

virtual void CalcRectEdit(CRect& rectEdit);

參數

rectEdit
[in]指定索引標籤區域的矩形。

備註

當您變更索引標籤的標籤時，會呼叫這個方法。這個方法會將指定矩形的左右兩側解除為目前定位點高度的一半，並將頂端和底部解構為一個單位。

`CMFCTabCtrl::EnableActiveTabCloseButton`

顯示或隱藏 使用中索引標籤上的 [關閉 ] 按鈕（ X。

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

參數

bEnable
[in] TRUE 表示顯示 使用中索引標籤上的 [關閉 ] 按鈕; FALSE 表示在索引卷標區域的右上角顯示 [關閉 ] 按鈕。預設值是 TRUE。

`CMFCTabCtrl::EnableInPlaceEdit`

啟用或停用可編輯的索引標籤。

virtual void EnableInPlaceEdit(BOOL bEnable);

參數

bEnable
[in] TRUE 表示啟用可編輯的索引標籤; FALSE 表示停用可編輯的索引標籤。

備註

`CMFCTabCtrl::EnableTabDocumentsMenu`

在使用者介面之間切換，該介面會使用兩個按鈕來捲動視窗索引標籤，以及顯示索引標籤視窗彈出視窗的介面。

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

參數

bEnable
[in] TRUE 顯示索引標籤視窗標籤的快捷選單; FALSE 表示向前和向後捲動按鈕。預設值是 TRUE。

備註

當使用者按兩下索引標籤時，架構會顯示對應的索引標籤視窗。如果顯示索引標籤，則會開啟索引標籤視窗，而不會變更其位置。如果使用者從彈出視窗中選取檔，且對應的索引標籤視窗已關閉畫面，則索引標籤視窗會變成第一個索引標籤。

`CMFCTabCtrl::EnsureVisible`

確保索引標籤可見。

virtual BOOL EnsureVisible(int iTab);

參數

iTab
[in] 定位點之以零起始的索引。

傳回值

TRUE 如果成功，則為 ; FALSE iTab 如果參數索引無效，則為。

備註

使用這個方法來保證指定的索引標籤可見。如果需要，索引標籤機件將會捲動。

`CMFCTabCtrl::GetDocumentIcon`

擷取與索引標籤視窗彈出視窗中索引標籤相關聯的影像。

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

參數

nCmdID
[in]索引標籤視窗彈出視窗中索引標籤的命令標識碼。

傳回值

位圖影像的句柄。

`CMFCTabCtrl::GetFirstVisibleTabNum`

擷取目前索引標籤中可見的第一個索引標籤。

virtual int GetFirstVisibleTabNum() const;

傳回值

索引標籤控件中索引標籤的以零起始。

備註

只有當 Tab 控制項以 Microsoft oneNote 的樣式顯示時，才使用這個方法。 CMFCTabCtrl::IsOneNoteStyle使用方法來判斷樣式。

`CMFCTabCtrl::GetResizeMode`

擷取值，指定如何調整目前索引標籤件的大小。

ResizeMode GetResizeMode() const;

傳回值

其中 CMFCTabCtrl::ResizeMode 一個列舉值，指定如何調整索引標籤的大小。如需可能值的清單，請參閱方法的 CMFCTabCtrl::SetResizeMode 一節。

`CMFCTabCtrl::GetScrollBar`

擷取與選項卡控件相關聯的滾動條物件的指標。

CScrollBar* GetScrollBar();

傳回值

捲動條物件的指標，如果使用樣式建立STYLE_FLAT_SHARED_HORZ_SCROLL索引標籤件，則NULL為。

備註

使用此方法可存取索引標籤的內嵌滾動條。只有在索引標籤元件具有 STYLE_FLAT_SHARED_HORZ_SCROLL 樣式時，才會建立滾動條物件。

`CMFCTabCtrl::GetTabArea`

擷取選項卡控件頂端或底部索引卷標區域的周框。

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

參數

rectTabAreaTop
[out]當這個方法傳回時，這個參考會包含將頂端索引卷標區域系結的矩形。矩形位於用戶端座標中。如果索引標籤區域不存在於索引標籤控制件頂端，則此參考是空的。

rectTabAreaBottom
[out]當這個方法傳回時，這個參考會包含一個矩形，這個矩形會系結底部索引卷標區域。矩形位於用戶端座標中。如果索引標籤元件底部沒有索引標籤區域，則此參考是空的。

備註

使用此方法可決定索引標籤視窗中索引標籤區域的大小和位置。

`CMFCTabCtrl::GetTabMaxWidth`

擷取索引標籤的最大寬度。

int GetTabMaxWidth() const;

傳回值

索引標籤的最大寬度，以像素為單位。如果傳回值為 0，索引標籤寬度是無限制的。

備註

使用 CMFCTabCtrl：：SetTabMaxWidth 方法來設定索引標籤寬度上限。

`CMFCTabCtrl::GetTabsHeight`

擷取目前索引標籤之索引標籤的高度。

virtual int GetTabsHeight() const;

傳回值

如果任何索引標籤可見，則為索引標籤區域的高度，如果看不到任何索引標籤，則為零。

`CMFCTabCtrl::GetTabsRect`

擷取矩形，這個矩形會系結目前選項卡控件的索引卷標區域。

virtual void GetTabsRect(CRect& rect) const;

參數

rect
[out]當這個方法傳回時， rect 參數會包含一個矩形，這個矩形會系結索引卷標區域。

`CMFCTabCtrl::GetWndArea`

擷取目前索引標籤之工作區的界限。

void GetWndArea(CRect& rect) const;

參數

rect
[in， out]當這個方法傳回時，此參數會包含系結目前選項卡控件的矩形。

備註

`CMFCTabCtrl::HideActiveWindowHorzScrollBar`

隱藏活動視窗中的水準滾動條，如果有的話。

void HideActiveWindowHorzScrollBar();

備註

使用此方法可防止當使用者在索引標籤頁面之間切換時，Tab 控件閃爍。

`CMFCTabCtrl::HideInactiveWindow`

指定架構是否顯示非使用中的索引標籤視窗。

void HideInactiveWindow(BOOL bHide = TRUE);

參數

bHide
[in] TRUE 不顯示非使用中的視窗; FALSE 表示顯示非使用中的視窗。預設值是 TRUE。

備註

`CMFCTabCtrl::HideNoTabs`

如果沒有可見的索引標籤，啟用或停用索引標籤區域的繪圖。

void HideNoTabs(BOOL bHide=TRUE);

參數

bHide
[in] TRUE 表示啟用繪製索引標籤區域; FALSE 表示停用繪圖。預設值是 TRUE。

備註

`CMFCTabCtrl::HideSingleTab`

如果有單一索引標籤視窗，則啟用或停用索引標籤繪圖。

virtual void HideSingleTab(BOOL bHide=TRUE);

參數

bHide
[in] TRUE 表示不繪製單一索引標籤視窗的索引標籤; FALSE 表示繪製單一索引標籤。預設值為 TRUE。

備註

`CMFCTabCtrl::IsActiveInMDITabGroup`

指出選項卡控件的目前索引標籤是否為多個文檔介面索引標籤群組中的使用中索引標籤。

BOOL IsActiveInMDITabGroup() const;

傳回值

TRUE 如果索引標籤控件的目前索引標籤是 MDI 索引標籤中的使用中索引標籤，則為 ;否則為 FALSE。

備註

您可以將多個文件視窗組織成垂直或水準索引標籤群組，並輕鬆地將檔從一個索引標籤群組隨機顯示到另一個索引卷標群組。

`CMFCTabCtrl::IsActiveTabBoldFont`

指出使用中索引標籤的文字是否使用粗體字型顯示。

BOOL IsActiveTabBoldFont() const;

傳回值

TRUE 如果使用粗體字型顯示使用中的索引標籤，則為 ;否則為 FALSE。

備註

CMFCTabCtrl::SetActiveTabBoldFont使用方法來變更使用中的索引標籤型。

`CMFCTabCtrl::IsActiveTabCloseButton`

指出 [關閉] 按鈕（X）是否顯示在使用中索引標籤上，或顯示在索引卷標區域的右上角。

virtual BOOL IsActiveTabCloseButton() const;

傳回值

TRUE如果 [關閉] 按鈕顯示在使用中索引標籤上，則為 ;FALSE如果 [關閉] 按鈕顯示在索引標籤區域的右上角，則為。

備註

`CMFCTabCtrl::IsDrawFrame`

指出索引卷標式視窗是否會在內嵌窗格周圍繪製框架矩形。

BOOL IsDrawFrame() const;

傳回值

TRUE 如果繪製框架矩形則為 ;否則為 FALSE。

備註

CMFCTabCtrl::SetDrawFrame使用方法來啟用或停用繪製框架矩形。

`CMFCTabCtrl::IsFlatFrame`

指出索引標籤區域周圍的框架是平面或 3D。

BOOL IsFlatFrame() const;

傳回值

TRUE 如果索引標籤區域周圍的框架是平面的，則為 ; FALSE 如果框架為三維，則為。

備註

CMFCTabCtrl::SetFlatFrame使用方法來變更繪製框架的方式。

`CMFCTabCtrl::IsFlatTab`

指出目前索引標籤控件中索引標籤的外觀是否一般。

virtual BOOL IsFlatTab() const;

傳回值

TRUE 如果目前索引標籤元件中的索引標籤外觀是平面的，則為 ;否則為 FALSE。

`CMFCTabCtrl::IsLeftRightRounded`

指出目前索引標籤控件中索引標籤左邊和右側的外觀是否四捨五入。

virtual BOOL IsLeftRightRounded() const;

傳回值

TRUE 如果每個索引標籤的兩側四捨五入則為 ;否則為 FALSE。

`CMFCTabCtrl::IsMDITabGroup`

指出目前索引標籤是否包含在多文檔介面視窗的工作區中。

virtual BOOL IsMDITabGroup() const;

傳回值

TRUE 如果目前的索引標籤元件位於 MDI 工作區視窗中，則為 ;否則為 FALSE。

`CMFCTabCtrl::IsOneNoteStyle`

指出目前的索引標籤控制項是否以 Microsoft OneNote 的樣式顯示。

virtual BOOL IsOneNoteStyle() const;

傳回值

TRUE 如果 Tab 控制項以 Microsoft OneNote 的樣式顯示，則為 ;否則為 FALSE。

`CMFCTabCtrl::IsSharedScroll`

指出目前的索引標籤控件是否有滾動條，可將其索引卷動為群組的索引標籤。

BOOL IsSharedScroll() const;

傳回值

TRUE 如果索引標籤元件有共用滾動條，則為 ;否則為 FALSE。

備註

如果方法的 CMFCTabCtrl::Create 參數為 STYLE_FLAT_SHARED_HORZ_SCROLL，style這個方法會傳TRUE回。

`CMFCTabCtrl::IsTabDocumentsMenu`

指出索引標籤控件是否顯示卷動按鈕，或顯示索引標籤視窗選單的按鈕。

BOOL IsTabDocumentsMenu() const;

傳回值

TRUE 如果使用索引標籤視窗標籤的捷徑的捷徑選單卷動索引標籤，則為 ; FALSE 如果使用向前和向後捲動按鈕捲動索引捲動視窗，則為。

備註

CMFCTabCtrl::EnableTabDocumentsMenu使用方法來指定卷動索引標籤視窗的方法。

`CMFCTabCtrl::IsVS2005Style`

指出是否使用Visual Studio 2005的樣式繪製索引標籤。

virtual BOOL IsVS2005Style() const;

傳回值

TRUE 如果使用 Visual Studio 2005 的樣式繪製索引標籤，則為 ;否則為 FALSE。

備註

style使用方法的 CMFCTabCtrl::Create 參數來指定索引標籤的繪製方式。

`CMFCTabCtrl::m_bEnableActivate`

當插入並啟用新的索引標籤時，防止使用中檢視失去焦點。

static BOOL m_bEnableActivate;

備註

當插入索引標籤並設為使用中時，焦點通常是由新的索引標籤視窗所取得。將 CMFCTabCtrl::m_bEnableActivate 成員變數設定為 FALSE 以保留原始焦點。預設值是 TRUE。

`CMFCTabCtrl::ModifyTabStyle`

指定目前索引標籤控件中索引標籤的外觀。

BOOL ModifyTabStyle(Style style);

參數

style
[in]其中一個列舉值，指定選項卡控件的外觀。如需詳細資訊，請參閱中的表格。

傳回值

一律為 TRUE。

備註

參數的值 style 可以是下列 CMFCTabCtrl::Style 其中一個列舉。

名稱	描述
`STYLE_3D`	顯示具有圓角的三維矩形索引標籤。
`STYLE_3D_ONENOTE`	顯示具有一個垂直側和一個斜邊且具有圓角的三維索引標籤。
`STYLE_3D_ROUNDED`	顯示具有斜邊和圓角的三維索引標籤。
`STYLE_3D_ROUNDED_SCROLL`	顯示具有斜邊和圓角的三維索引標籤。如果索引標籤數目比可以同時顯示更多，則架構會顯示下拉式箭號和索引卷標功能表，讓索引標籤成為使用中狀態。
`STYLE_3D_SCROLLED`	顯示三維矩形索引標籤。如果索引標籤數目比可以同時顯示更多，則架構會顯示下拉式箭號和索引卷標功能表，讓索引標籤成為使用中狀態。
`STYLE_3D_VS2005`	顯示三維、四捨五入的索引標籤，其側邊有一個斜線和一個垂直側邊。
`STYLE_FLAT`	顯示傾斜左右兩側的二維索引標籤。
`STYLE_FLAT_SHARED_HORZ_SCROLL`	顯示二維索引標籤。如果索引標籤數目超過可以同時顯示的索引標籤，則架構會在索引標籤區域的結尾顯示滾動箭頭。

`CMFCTabCtrl::OnDragEnter`

當游標第一次進入目前索引標籤的視窗時，架構會在拖放作業期間由架構呼叫。

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

參數

pDataObject
[in]指向包含使用者拖曳之數據的數據物件。

dwKeyState
[in]包含修飾詞索引鍵的狀態。此參數是下列值的位元組合「or」（|）：MK_CONTROL、MK_SHIFT、MK_ALT、 MK_LBUTTONMK_MBUTTON和 MK_RBUTTON。如需詳細資訊，請參閱關於滑鼠輸入的訊息參數一節。

point
[in]包含用戶端座標中游標的目前位置。

傳回值

一律 DROPEFFECT_NONE為，這表示置放目標無法接受數據。

備註

使用這個方法來支援拖放作業。覆寫此方法以實作您自己的自定義行為。

根據預設，這個方法只會呼叫 CMFCTabCtrl::OnDragOver，這個方法一律會傳 DROPEFFECT_NONE回。

`CMFCTabCtrl::OnDragOver`

當滑鼠移到置放目標視窗上方時，架構會在拖曳作業期間由架構呼叫。

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

參數

pDataObject
[in] COleDataObject 正在拖曳至置放目標上的物件指標。

dwKeyState
[in]修飾詞索引鍵的狀態，這是、、、MK_ALT、、MK_MBUTTONMK_LBUTTON 和 MK_RBUTTON的MK_CONTROL位組合「or」（） MK_SHIFT| 如需詳細資訊，請參閱關於滑鼠輸入中的。

point
[in]目前的滑鼠位置。

傳回值

一律為 DROPEFFECT_NONE。

備註

使用您的自定義實作覆寫這個方法。如需詳細資訊，請參閱 CView::OnDragOver 方法。

`CMFCTabCtrl::OnShowTabDocumentsMenu`

顯示索引標籤視窗的彈出視窗，等候使用者選取索引標籤，並將選取的索引標籤變成使用中索引標籤。

virtual void OnShowTabDocumentsMenu(CPoint point);

參數

point
[in]顯示快捷功能表之位置的座標。

備註

`CMFCTabCtrl::SetActiveInMDITabGroup`

將索引標籤的目前索引標籤設定為多個文件介面索引標籤群組中的使用中索引標籤。

void SetActiveInMDITabGroup(BOOL bActive);

參數

bActive
[in] TRUE 讓目前索引標籤成為使用中索引標籤; FALSE 讓目前的索引標籤處於非使用中狀態。

備註

您可以將多個文件視窗組織成垂直或水準索引標籤群組，並輕鬆地將檔從一個索引標籤群組隨機顯示到另一個索引卷標群組。

`CMFCTabCtrl::SetActiveTab`

啟動索引標籤。

virtual BOOL SetActiveTab(int iTab);

參數

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

傳回值

TRUE 如果指定的索引標籤已作用中，則為 ; FALSE 如果指定的 iTab 參數值無效，則為。

備註

這會將 AFX_WM_CHANGE_ACTIVE_TAB 通知傳送至父視窗和索引標籤控件的父框架。

方法 SetActiveTab 會自動呼叫 CMFCTabCtrl::HideActiveWindowHorzScrollBar 方法，以防止畫面閃爍。

`CMFCTabCtrl::SetActiveTabBoldFont`

啟用或停用使用中索引標籤上的粗體字型。

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

參數

bIsBold
[in] TRUE 表示使用粗體字型來顯示使用中索引標籤的標籤; FALSE 使用標準字型來顯示標籤。預設值是 TRUE。

備註

`CMFCTabCtrl::SetDrawFrame`

指定框架矩形是否繪製在內嵌長條周圍。

void SetDrawFrame(BOOL bDraw=TRUE);

參數

bDraw
[in] TRUE 表示在內嵌列周圍顯示框架矩形;否則為 FALSE。預設值是 TRUE。

備註

`CMFCTabCtrl::SetFlatFrame`

指定在索引標籤區域周圍繪製平面或 3D 框架。

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

參數

bFlat
[in] TRUE 繪製製表區域周圍的平面（2D）框架; FALSE 繪製三維（3D）框架。預設值是 TRUE。

bRepaint
[in] TRUE 表示立即重新繪製視窗;否則為 FALSE。預設值是 TRUE。

備註

`CMFCTabCtrl::SetImageList`

指定影像清單。

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

參數

uiID
[in]包含影像清單的點陣圖資源識別碼。

cx
[in]每個影像的寬度，以像素為單位。預設值為 15。

clrTransp
[in]透明影像色彩。此色彩影像的部分會是透明的。默認值為色彩洋紅，RGB（255,0,255）。

hImageList
[in] 預先載入影像清單的控制代碼。

傳回值

TRUE 如果這個方法成功，則為。 FALSE 如果使用一般樣式或第一個方法多載無法載入參數所 uiID 指定的點陣圖，則為索引標籤控件。

備註

使用此方法可設定索引標籤的影像清單。影像清單中的影像會顯示在索引標籤旁邊。這個方法會重新計算索引標籤高度，讓索引標籤的大小同時包含影像和文字。

CMFCBaseTabCtrl::AddTab使用 Tab 控制項所繼承的方法，指定要顯示的影像索引。

`CMFCTabCtrl::SetResizeMode`

指定如何調整目前索引標籤的大小，然後重新顯示控制件。

void SetResizeMode(ResizeMode resizeMode);

參數

resizeMode
[in]其中 CMFCTabCtrl::ResizeMode 一個列舉值，指定如何調整索引標籤的大小。如需可能值的清單，請參閱中的表格。

備註

resizeMode 參數可以是下列ResizeMode其中一個列舉值。

名稱	描述
`RESIZE_NO`	無法調整索引標籤的大小。
`RESIZE_VERT`	索引標籤可以垂直重設大小，但無法水平重設大小。
`RESIZE_HORIZ`	索引標籤可以水平重設大小，但不能垂直重設大小。

`CMFCTabCtrl::SetTabMaxWidth`

指定索引標籤視窗中的索引標籤寬度上限。

void SetTabMaxWidth(int nTabMaxWidth);

參數

nTabMaxWidth
[in]索引標籤寬度上限，以像素為單位。

備註

使用此方法可限制索引標籤視窗中每個索引標籤的寬度。如果索引標籤有很長的標籤，這個方法就很有用。類別建 CMFCTabCtrl 構函式會將索引標籤寬度上限初始化為 0，這實際上表示寬度不受限制。

`CMFCTabCtrl::StopResize`

終止索引標籤控件上目前的重設大小作業。

void StopResize(BOOL bCancel);

參數

bCancel
[in] TRUE 表示放棄目前的重設大小作業; FALSE 完成目前的重設大小作業。不論是哪一種情況，架構都停止繪製重設大小矩形。

`CMFCTabCtrl::SynchronizeScrollBar`

在顯示一般索引標籤的索引標籤上繪製水平滾動條。

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

參數

pScrollInfo
[out] SCROLLINFO 結構或 NULL的指標。當這個方法傳回時，如果此參數不是 NULL，則結構會包含滾動條的所有參數。預設值是 NULL。

傳回值

TRUE 如果此方法成功，則為 ;否則為 FALSE。

備註

這個方法只會影響顯示一般索引標籤的索引標籤元件。滾動條會同時影響所有索引標籤。

另請參閱

階層架構圖表
 類別
 CDockablePane 類
 CMFCBaseTabCtrl 類

共用方式為

CMFCTabCtrl 類別

語法

成員

公用建構函式

公用方法

資料成員

備註

繼承階層架構

範例

需求

CMFCTabCtrl::ActivateMDITab

參數

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

傳回值

備註

CMFCTabCtrl::AutoSizeWindow

參數

備註

CMFCTabCtrl::Create

參數

傳回值

備註

範例

CMFCTabCtrl::CalcRectEdit

參數

備註

CMFCTabCtrl::EnableActiveTabCloseButton

參數

CMFCTabCtrl::EnableInPlaceEdit

參數

備註

CMFCTabCtrl::EnableTabDocumentsMenu

參數

備註

CMFCTabCtrl::EnsureVisible

參數

傳回值

備註

CMFCTabCtrl::GetDocumentIcon

參數

傳回值

CMFCTabCtrl::GetFirstVisibleTabNum

傳回值

備註

CMFCTabCtrl::GetResizeMode

傳回值

CMFCTabCtrl::GetScrollBar

傳回值

備註

CMFCTabCtrl::GetTabArea

參數

備註

CMFCTabCtrl::GetTabMaxWidth

傳回值

備註

CMFCTabCtrl::GetTabsHeight

傳回值

CMFCTabCtrl::GetTabsRect

參數

CMFCTabCtrl::GetWndArea

參數

備註

CMFCTabCtrl::HideActiveWindowHorzScrollBar

備註

CMFCTabCtrl::HideInactiveWindow

參數

備註

CMFCTabCtrl::HideNoTabs

參數

備註

CMFCTabCtrl::HideSingleTab

參數

備註

CMFCTabCtrl::IsActiveInMDITabGroup

傳回值

備註

CMFCTabCtrl::IsActiveTabBoldFont

傳回值

備註