分享方式:


CTabView 類別

類別 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 類別