`CMFCTabCtrl` 類別

發行項
04/03/2023

類別 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`	在 Microsoft OneNote 的樣式中建立索引標籤控制項。
`STYLE_3D_VS2005`	在 Microsoft Visual Studio 2005 樣式中建立索引標籤控制項。
`STYLE_3D_ROUNDED`	在 Microsoft Visual Studio 2005 樣式中建立具有四捨五入索引標籤的索引標籤控制項。
`STYLE_3D_ROUNDED_SCROLL`	使用 Microsoft Visual Studio 2005 樣式的圓角索引標籤和捲動按鈕，建立索引標籤控制項。

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

位置	描述
`LOCATION_BOTTOM`	索引標籤位於索引標籤控制項的底部。
`LOCATION_TOP`	索引標籤位於索引標籤控制項的頂端。

範例

下列範例示範如何在類別中使用 CreateCMFCTabCtrl 方法。此範例是 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 如果成功，則為 ; FALSEiTab 如果參數索引無效，則為。

備註

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

`CMFCTabCtrl::GetDocumentIcon`

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

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

參數

nCmdID
[in]索引標籤視窗快顯視窗中索引標籤的命令識別碼。

傳回值

點陣圖影像的控制碼。

`CMFCTabCtrl::GetFirstVisibleTabNum`

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

virtual int GetFirstVisibleTabNum() const;

傳回值

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

備註

只有在索引標籤控制項以 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 如果索引標籤控制項以 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_LBUTTONMK_MBUTTON 和 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

傳回值

備註