CTabView-Klasse

Die CTabView Klasse vereinfacht die Verwendung der Registerkartensteuerelementklasse ( CMFCTabCtrl) in Anwendungen, die die Dokument-/Ansichtsarchitektur von MFC verwenden.

Syntax

class CTabbedView : public CView

Member

Öffentliche Methoden

Name	Beschreibung
CTabView::AddView	Fügt dem Registerkartensteuerelement eine neue Ansicht hinzu.
CTabView::FindTab	Gibt den Index der angegebenen Ansicht im Registerkartensteuerelement zurück.
CTabView::GetActiveView	Gibt einen Zeiger auf die aktuell aktive Ansicht zurück.
CTabView::GetTabControl	Gibt einen Verweis auf das Registerkartensteuerelement zurück, das der Ansicht zugeordnet ist.
CTabView::RemoveView	Entfernt die Ansicht aus dem Registerkartensteuerelement.
CTabView::SetActiveView	Macht eine Ansicht aktiv.

Geschützte Methoden

Name	Beschreibung
CTabView::IsScrollBar	Wird vom Framework aufgerufen, wenn sie eine Registerkartenansicht erstellen, um zu bestimmen, ob die Registerkartenansicht über eine freigegebene horizontale Bildlaufleiste verfügt.
CTabView::OnActivateView	Wird vom Framework aufgerufen, wenn die Registerkartenansicht aktiv oder inaktiv wird.

Hinweise

Diese Klasse erleichtert das Einfügen einer Ansicht mit Registerkarten in eine Dokument-/Ansichtsanwendung. CTabView ist eine CViewabgeleitete Klasse, die ein eingebettetes CMFCTabCtrl Objekt enthält. CTabView behandelt alle Nachrichten, die erforderlich sind, um das CMFCTabCtrl Objekt zu unterstützen. Leiten Sie einfach eine Klasse ab CTabView und fügen Sie sie in Ihre Anwendung ein, und fügen Sie dann mithilfe der AddView Methode abgeleitete Klassen hinzuCView. Das Registerkartensteuerelement zeigt diese Ansichten als Registerkarten an.

Sie können z. B. ein Dokument haben, das auf unterschiedliche Weise dargestellt werden kann: als Kalkulationstabelle, als Diagramm, ein bearbeitbares Formular usw. Sie können einzelne Ansichten erstellen, die die Daten nach Bedarf zeichnen, sie in Ihr CTabViewabgeleitetes Objekt einfügen und ohne zusätzliche Codierung tabbed haben.

TabbedView-Beispiel: MFC Tabbed View Application veranschaulicht die Verwendung von CTabView.

Beispiel

Das folgende Beispiel zeigt, wie CTabView im TabbedView-Beispiel verwendet wird.

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

Anforderungen

Header: afxTabView.h

CTabView::AddView

Fügt dem Registerkartensteuerelement eine Ansicht hinzu.

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

Parameter

pViewClass
[in] Ein Zeiger auf eine Laufzeitklasse der eingefügten Ansicht.

strViewLabel
[in] Gibt den Text der Registerkarte an.

iIndex
[in] Gibt die nullbasierte Position an, an der die Ansicht eingefügt werden soll. Wenn die Position -1 ist, wird die neue Registerkarte am Ende eingefügt.

pContext
[in] Ein Zeiger auf die CCreateContext Ansicht.

Rückgabewert

Ein Ansichtsindex, wenn diese Methode erfolgreich ist. Andernfalls: -1

Hinweise

Rufen Sie diese Funktion auf, um dem Registerkartensteuerelement, das in einen Frame eingebettet ist, eine Ansicht hinzuzufügen.

CTabView::FindTab

Gibt den Index der angegebenen Ansicht im Registerkartensteuerelement zurück.

int FindTab(HWND hWndView) const;

Parameter

hWndView
[in] Der Ziehpunkt der Ansicht.

Rückgabewert

Der Index der Ansicht, wenn sie gefunden wird; andernfalls -1.

Hinweise

Rufen Sie diese Funktion auf, um den Index einer Ansicht abzurufen, die über einen angegebenen Handle verfügt.

CTabView::GetActiveView

Gibt einen Zeiger auf die aktuell aktive Ansicht zurück.

CView* GetActiveView() const;

Rückgabewert

Ein gültiger Zeiger auf die aktive Ansicht oder NULL, wenn keine aktive Ansicht vorhanden ist.

Hinweise

CTabView::GetTabControl

Gibt einen Verweis auf das Registerkartensteuerelement zurück, das der Ansicht zugeordnet ist.

DECLARE_DYNCREATE CMFCTabCtrl& GetTabControl();

Rückgabewert

Ein Verweis auf das Registerkartensteuerelement, das der Ansicht zugeordnet ist.

CTabView::IsScrollBar

Wird vom Framework aufgerufen, wenn sie eine Registerkartenansicht erstellen, um zu bestimmen, ob die Registerkartenansicht über eine freigegebene horizontale Bildlaufleiste verfügt.

virtual BOOL IsScrollBar() const;

Rückgabewert

TRUE, wenn die Registerkartenansicht zusammen mit einer freigegebenen Bildlaufleiste erstellt werden soll. Andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, wenn ein CTabView-Objekt erstellt wird.

Überschreiben Sie die IsScrollBar-Methode in einer von CTabView abgeleiteten Klasse und geben TRUE zurück, wenn Sie eine Ansicht mit einer freigegebenen horizontalen Bildlaufleiste erstellen möchten.

CTabView::OnActivateView

Wird vom Framework aufgerufen, wenn die Registerkartenansicht aktiv oder inaktiv wird.

virtual void OnActivateView(CView* view);

Parameter

view
[in] Ein Zeiger auf die Ansicht.

Hinweise

Bei der Standardimplementierung wird keine Aktion ausgeführt. Überschreiben Sie diese Methode in einer CTabViewabgeleiteten Klasse, um diese Benachrichtigung zu verarbeiten.

CTabView::RemoveView

Entfernt die Ansicht aus dem Registerkartensteuerelement.

BOOL RemoveView(int iTabNum);

Parameter

iTabNum
[in] Der Index der zu entfernenden Ansicht.

Rückgabewert

Der Index der entfernten Ansicht, wenn diese Methode erfolgreich ist. Andernfalls -1.

Hinweise

CTabView::SetActiveView

Macht eine Ansicht aktiv.

BOOL SetActiveView(int iTabNum);

Parameter

iTabNum
[in] Der nullbasierte Index der Registerkartenansicht.

Rückgabewert

TRUE, wenn die angegebene Ansicht aktiv wurde, FALSE, wenn der Index der Ansicht ungültig ist.

Hinweise

Weitere Informationen finden Sie unter CMFCTabCtrl::SetActiveTab.

Siehe auch

Hierarchiediagramm
Klassen
CMFCTabCtrl
CView-Klasse