CTabView 類別

發行項
10/12/2023

類別 CTabView 可簡化使用 MFC 檔/檢視架構之應用程式中的索引標籤控制項類別（ CMFCTabCtrl ）的使用。

語法

class CTabbedView : public CView

成員

公用方法

名稱	描述
CTabView：：AddView	將新的檢視加入至索引標籤控制項。
CTabView：：FindTab	傳回索引標籤控制項中指定檢視的索引。
CTabView：：GetActiveView	傳回目前使用中檢視的指標
CTabView：：GetTabControl	傳回與檢視相關聯之索引標籤控制項的參考。
CTabView：：RemoveView	從索引標籤控制項移除檢視。
CTabView：：SetActiveView	讓檢視成為使用中。

受保護的方法

名稱	描述
CTabView：：IsScrollBar	建立索引標籤檢視時由架構呼叫，以判斷索引標籤檢視是否具有共用的水準捲軸。
CTabView：：OnActivateView	當索引標籤檢視成為使用中或非使用中時，由架構呼叫。

備註

這個類別可讓您輕鬆地將索引標籤式檢視放入檔/檢視應用程式中。 CTabViewCView是包含內嵌 CMFCTabCtrl 物件的衍生類別。 CTabView 會處理支援 CMFCTabCtrl 物件所需的所有訊息。只要從 CTabView 衍生類別並將其插入您的應用程式，然後使用方法新增 CView 衍生類別 AddView 。索引標籤控制項會將這些檢視顯示為索引標籤。

例如，您可能有以不同方式表示的檔：以試算表、圖表、可編輯的表單等方式表示。您可以視需要建立繪製資料的個別檢視、將它們插入 CTabView 衍生物件，並讓它們定位，而不需要任何額外的編碼。

TabbedView 範例：MFC 索引標籤式檢視應用程式說明的使用 CTabView 方式。

範例

下列範例示範如何在 CTabView TabbedView 範例中使用。

class CTabbedViewView : public CTabView
{
protected: // create from serialization only
   CTabbedViewView();
   DECLARE_DYNCREATE(CTabbedViewView)

   // Attributes
public:
   CTabbedViewDoc *GetDocument();

   // Operations
public:
   // Overrides
public:
   virtual void OnDraw(CDC *pDC); // overridden to draw this view
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);

protected:
   virtual BOOL OnPreparePrinting(CPrintInfo *pInfo);
   virtual void OnBeginPrinting(CDC *pDC, CPrintInfo *pInfo);
   virtual void OnEndPrinting(CDC *pDC, CPrintInfo *pInfo);

   BOOL IsScrollBar() const
   {
      return TRUE;
   }

   // Implementation
public:
   virtual ~CTabbedViewView();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg BOOL OnEraseBkgnd(CDC *pDC);
   afx_msg void OnContextMenu(CWnd *, CPoint point);
   afx_msg void OnFilePrintPreview();

   DECLARE_MESSAGE_MAP()
};

需求

標頭： afxTabView.h

CTabView：：AddView

將檢視加入至索引標籤控制項。

int AddView(
    CRuntimeClass* pViewClass,
    const CString& strViewLabel,
    int iIndex=-1,
    CCreateContext* pContext=NULL);

參數

pViewClass
[in]插入檢視之執行時間類別的指標。

strViewLabel
[in]指定索引標籤的文字。

iIndex
[in]指定要插入檢視之以零起始的位置。如果位置為 -1，則會在結尾插入新的索引標籤。

pContext
[in]檢視的指標 CCreateContext 。

傳回值

如果此方法成功，則為檢視索引。否則為 -1。

備註

呼叫此函式，將檢視新增至內嵌在框架中的索引標籤控制項。

CTabView：：FindTab

傳回索引標籤控制項中指定檢視的索引。

int FindTab(HWND hWndView) const;

參數

hWndView
[in]檢視的控制碼。

傳回值

如果找到檢視表的索引;否則為 -1。

備註

呼叫此函式，以擷取具有指定控制碼的檢視索引。

CTabView：：GetActiveView

傳回目前使用中檢視的指標。

CView* GetActiveView() const;

傳回值

作用中檢視的有效指標，如果沒有使用中檢視則為 Null。

備註

CTabView：：GetTabControl

傳回與檢視相關聯之索引標籤控制項的參考。

DECLARE_DYNCREATE CMFCTabCtrl& GetTabControl();

傳回值

與檢視相關聯的索引標籤控制項參考。

CTabView：：IsScrollBar

建立索引標籤檢視時由架構呼叫，以判斷索引標籤檢視是否具有共用的水準捲軸。

virtual BOOL IsScrollBar() const;

傳回值

TRUE 是表示如果索引標籤檢視應該與共享捲軸一起建立。否則為 FALSE。

備註

建立 CTabView 物件時 ，架構會呼叫此方法。

覆寫 CTabView 衍生類別中的 IsScrollBar 方法，如果您想要建立具有共用水準捲軸的檢視，則傳回 TRUE。

CTabView：：OnActivateView

當索引標籤檢視成為使用中或非使用中時，由架構呼叫。

virtual void OnActivateView(CView* view);

參數

view
[in]檢視的指標。

備註

預設實作不做任何動作。覆寫衍生類別中的 CTabView 這個方法，以處理此通知。

CTabView：：RemoveView

從索引標籤控制項移除檢視。

BOOL RemoveView(int iTabNum);

參數

iTabNum
[in]要移除之檢視的索引。

傳回值

如果此方法成功，則為已移除檢視的索引。否則為 -1。

備註

CTabView：：SetActiveView

讓檢視成為使用中。

BOOL SetActiveView(int iTabNum);

參數

iTabNum
[in]索引標籤檢視以零起始的索引。

傳回值

如果指定的檢視是使用中，則為 TRUE，如果檢視的索引無效，則為 FALSE。

備註

如需詳細資訊，請參閱 CMFCTabCtrl：：SetActiveTab 。

另請參閱

階層架構圖表
 類別
 CMFCTabCtrl
CView 類別

共用方式為