CTabView osztály

Az CTabView osztály leegyszerűsíti a tabulátorvezérlő osztály ( CMFCTabCtrl) használatát az MFC dokumentum-/nézetarchitektúráját használó alkalmazásokban.

Szemantika

class CTabbedView : public CView

Tagok

Nyilvános metódusok

Név	Leírás
CTabView::AddView	Új nézetet ad hozzá a tabulátor vezérlőelemhez.
CTabView::FindTab	A tabulátor vezérlőelemben megadott nézet indexét adja vissza.
CTabView::GetActiveView	Mutatót ad vissza az aktuálisan aktív nézethez
CTabView::GettabControl	A nézethez társított tabulátor vezérlőelemre mutató hivatkozást ad vissza.
CTabView::RemoveView	Eltávolítja a nézetet a tabulátor vezérlőelemből.
CTabView::SetActiveView	A nézet aktívvá válik.

Védett metódusok

Név	Leírás
CTabView::IsScrollBar	A keretrendszer meghívta a tabulátornézet létrehozásakor annak megállapításához, hogy a tabulátor nézet rendelkezik-e megosztott vízszintes görgetősávtal.
CTabView::OnActivateView	A keretrendszer meghívja, amikor a tabulátornézet aktívvá vagy inaktívvá vált.

Megjegyzések

Ez az osztály megkönnyíti, hogy többlapos nézetet helyezzen el egy dokumentum-/nézetalkalmazásban. CTabView beágyazott objektumot CViewtartalmazó CMFCTabCtrl -származtatott osztály. CTabView kezeli az objektum támogatásához CMFCTabCtrl szükséges összes üzenetet. Egyszerűen származtasson egy osztályt, CTabView és csatlakoztassa az alkalmazáshoz, majd adjon hozzá CView-származtatott osztályokat a AddView metódus használatával. A tabulátor vezérlőelem lapként jeleníti meg ezeket a nézeteket.

Előfordulhat például, hogy egy dokumentum különböző módokon jeleníthető meg: számolótáblaként, diagramként, szerkeszthető űrlapként stb. Igény szerint egyéni nézeteket hozhat létre az adatok rajzolásához, beszúrhatja azokat a CTabViewszármaztatott objektumba, és további kódolás nélkül többlapossá teheti őket.

TabbedView-minta: Az MFC lapozott nézetalkalmazás a .CTabView

példa

Az alábbi példa bemutatja, hogyan CTabView használható a TabbedView-minta.

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

Követelmények

Fejléc: afxTabView.h

CTabView::AddView

Nézetet ad hozzá a tabulátor vezérlőelemhez.

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

Paraméterek

pViewClass
[in] Mutató a beszúrt nézet futtatókörnyezeti osztályára.

strViewLabel
[in] Megadja a lap szövegét.

iIndex
[in] Megadja a nézet beszúrásának nullaalapú pozícióját. Ha a pozíció -1 az új lap a végén lesz beszúrva.

pContext
[in] A nézetre CCreateContext mutató mutató.

Visszaadott érték

Nézetindex, ha ez a módszer sikeres. Ellenkező esetben -1.

Megjegyzések

Ezt a függvényt úgy hívhatja meg, hogy hozzáad egy nézetet a keretbe ágyazott tabulátor vezérlőelemhez.

CTabView::FindTab

A tabulátor vezérlőelemben megadott nézet indexét adja vissza.

int FindTab(HWND hWndView) const;

Paraméterek

hWndView
[in] A nézet fogópontja.

Visszaadott érték

A nézet indexe, ha megtalálható; ellenkező esetben -1.

Megjegyzések

Hívja meg ezt a függvényt egy adott leíróval rendelkező nézet indexének lekéréséhez.

CTabView::GetActiveView

Egy mutatót ad vissza az aktuálisan aktív nézethez.

CView* GetActiveView() const;

Visszaadott érték

Érvényes mutató az aktív nézetre vagy NULL értékre, ha nincs aktív nézet.

Megjegyzések

CTabView::GettabControl

A nézethez társított tabulátor vezérlőelemre mutató hivatkozást ad vissza.

DECLARE_DYNCREATE CMFCTabCtrl& GetTabControl();

Visszaadott érték

Hivatkozás a nézethez társított tabulátor vezérlőelemre.

CTabView::IsScrollBar

A keretrendszer meghívta a tabulátornézet létrehozásakor annak megállapításához, hogy a tabulátor nézet rendelkezik-e megosztott vízszintes görgetősávtal.

virtual BOOL IsScrollBar() const;

Visszaadott érték

IGAZ, ha a tabulátornézetet közös görgetősávon kell létrehozni. Ellenkező esetben az érték FALSE (HAMIS).

Megjegyzések

A keretrendszer ezt a metódust CTabView-objektum létrehozásakor hívja meg.

Bírálja felül az IsScrollBarmetódust egy CTabView-származtatott osztályban, és igaz értéket ad vissza, ha megosztott vízszintes görgetősávot tartalmazó nézetet szeretne létrehozni.

CTabView::OnActivateView

A keretrendszer meghívja, amikor a tabulátornézet aktívvá vagy inaktívvá vált.

virtual void OnActivateView(CView* view);

Paraméterek

nézet
[in] Mutató a nézethez.

Megjegyzések

Az alapértelmezett implementáció nem végez semmit. Bírálja felül ezt a metódust egy CTabView-származtatott osztályban az értesítés feldolgozásához.

CTabView::RemoveView

Eltávolítja a nézetet a tabulátor vezérlőelemből.

BOOL RemoveView(int iTabNum);

Paraméterek

iTabNum
[in] Az eltávolítandó nézet indexe.

Visszaadott érték

Ha ez a módszer sikeres, az eltávolított nézet indexe. Ellenkező esetben -1.

Megjegyzések

CTabView::SetActiveView

A nézet aktívvá válik.

BOOL SetActiveView(int iTabNum);

Paraméterek

iTabNum
[in] A tabulátornézet nulla alapú indexe.

Visszaadott érték

IGAZ, ha a megadott nézet aktív, HAMIS, ha a nézet indexe érvénytelen.

Megjegyzések

További információ: CMFCTabCtrl::SetActiveTab.

Lásd még

Hierarchiadiagram
osztályok
CMFCTabCtrl
CView osztály