CMFCTabCtrl 類別

發行項
02/28/2013

CMFCTabCtrl 類別針對索引標籤控制項的功能。索引標籤控制項顯示具有平面或三個維度的索引標籤將停駐的視窗在它的上方或下方。索引標籤會顯示文字和影像，並可變更色彩，在作用中。

class CMFCTabCtrl : public CMFCBaseTabCtrl

Members

公用建構函式

名稱	描述
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	擷取索引標籤的標籤區域的週框 (Bounding Rectangle) 的索引標籤控制項的上方或下方。 (覆寫 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	表示索引標籤控制項的目前索引標籤是否為作用中的索引標籤在多重文件介面 (MDI) 索引標籤群組中。
CMFCTabCtrl::IsActiveTabBoldFont	表示使用中索引標籤的文字以粗體字型，是否已經顯示。
CMFCTabCtrl::IsActiveTabCloseButton	表示 [關閉] 按鈕 ([x]) 是否在作用中的索引標籤或索引標籤區域右上角顯示。
CMFCTabCtrl::IsDrawFrame	表示索引標籤式視窗是否在內嵌窗格周圍繪製框架矩形。
CMFCTabCtrl::IsFlatFrame	表示索引標籤區域周圍的框架是否為或 3D。
CMFCTabCtrl::IsFlatTab	指示是否索引標籤會出現在目前的索引標籤控制項的是平面的。
CMFCTabCtrl::IsLeftRightRounded	表示索引標籤的左邊會出現在目前的索引標籤控制項是否會四捨五入。
CMFCTabCtrl::IsMDITabGroup	指示目前的索引標籤控制項是否在多重文件介面 (MDI) 視窗的工作區中。
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 函式之前，將 Windows 訊息。 (覆寫 CMFCBaseTabCtrl::PreTranslateMessage)。
CMFCTabCtrl::RecalcLayout	重新計算索引標籤控制項的內部配置。 (覆寫 CMFCBaseTabCtrl::RecalcLayout)。
CMFCTabCtrl::SetActiveInMDITabGroup	在多重文件介面 (MDI) 索引標籤群組中設定的索引標籤控制項的目前選項，使用中的索引標籤。
CMFCTabCtrl::SetActiveTab	起始選項。 (覆寫 CMFCBaseTabCtrl::SetActiveTab)。
CMFCTabCtrl::SetActiveTabBoldFont	啟用或變更使用中索引標籤的粗體字型中停用用法。
CMFCTabCtrl::SetDrawFrame	在內嵌列周圍啟用或停用 drawinga 框架矩形。
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 類別。

遵循下列步驟加入可調整大小，修正應用程式的索引標籤控制項:

建立 CTabbedPane 類別的執行個體。
請呼叫 CDockablePane::Create。
使用 CBaseTabbedPane::AddTab 或 CMFCBaseTabCtrl::InsertTab 加入新的索引標籤。
呼叫 CBasePane::EnableDocking ，讓目前的索引標籤控制項可以停駐在主框架視窗。
呼叫 CFrameWndEx::DockPane 內建索引標籤式視窗在主要畫面格。

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

繼承階層架構

範例

下列範例會在 CMFCTabCtrl 類別會示範如何使用各種方法設定 CMFCTabCtrl 物件。範例會說明如何將索引標籤，顯示在使用中索引標籤的 [關閉] 按鈕，可讓您編輯索引標籤的標籤和顯示索引標籤式視窗標籤快顯功能表。這個範例是狀態集合範例的一部分。

    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();