CTabView 類別
類別 CTabView
可簡化使用 MFC 檔/檢視架構之應用程式中的索引標籤控件類別 ( CMFCTabCtrl) 的使用。
語法
class CTabbedView : public CView
成員
公用方法
名稱 | 描述 |
---|---|
CTabView::AddView | 將新的檢視加入至索引標籤件。 |
CTabView::FindTab | 傳回索引標籤控件中指定檢視的索引。 |
CTabView::GetActiveView | 傳回目前使用中檢視的指標 |
CTabView::GetTabControl | 傳回與檢視相關聯之索引標籤件的參考。 |
CTabView::RemoveView | 從索引標籤控件移除檢視。 |
CTabView::SetActiveView | 讓檢視成為使用中。 |
受保護的方法
名稱 | 描述 |
---|---|
CTabView::IsScrollBar | 建立索引卷標檢視時由架構呼叫,以判斷索引卷標檢視是否具有共用的水準滾動條。 |
CTabView::OnActivateView | 當索引卷標檢視成為使用中或非使用中時,由架構呼叫。 |
備註
這個類別可讓您輕鬆地將索引標籤式檢視放入檔/檢視應用程式中。 CTabView
CView
是包含內嵌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。