共用方式為


CMFCTabCtrl 類別

類別 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 在分派至 TranslateMessageDispatchMessage 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 類別

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

  1. 建立 ClassCTabbedPane實例。

  2. 呼叫 CDockablePane::Create

  3. 使用 CBaseTabbedPane::AddTabCMFCBaseTabCtrl::InsertTab 新增索引標籤。

  4. 呼叫 CBasePane::EnableDocking ,讓目前的停駐索引標籤可以停駐在主框架視窗。

  5. 呼叫 CFrameWndEx::DockPane 以停駐主框架的索引標籤視窗。

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

繼承階層架構

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

範例

下列範例示範如何使用 類別中的 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_SCROLLstyle這個方法會傳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_CONTROLMK_SHIFTMK_ALTMK_LBUTTONMK_MBUTTONMK_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_LBUTTONMK_RBUTTONMK_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