CTabView, classe

La CTabView classe simplifie l’utilisation de la classe de contrôle Tab ( CMFCTabCtrl) dans les applications qui utilisent l’architecture document/vue de MFC.

Syntaxe

class CTabbedView : public CView

Membres

Méthodes publiques

Nom	Description
CTabView ::AddView	Ajoute un nouvel affichage au contrôle tabulation.
CTabView ::FindTab	Retourne l’index de la vue spécifiée dans le contrôle Tab.
CTabView ::GetActiveView	Retourne un pointeur vers la vue actuellement active
CTabView ::GetTabControl	Retourne une référence au contrôle Tab associé à la vue.
CTabView ::RemoveView	Supprime l’affichage du contrôle Tab.
CTabView ::SetActiveView	Active une vue.

Méthodes protégées

Nom	Description
CTabView ::IsScrollBar	Appelé par l’infrastructure lors de la création d’un affichage onglet pour déterminer si l’affichage onglet a une barre de défilement horizontale partagée.
CTabView ::OnActivateView	Appelé par l’infrastructure lorsque l’affichage onglet est rendu actif ou inactif.

Notes

Cette classe facilite la mise en forme d’une vue par onglets dans une application de document/vue. CTabView est une CViewclasse dérivée qui contient un objet incorporé CMFCTabCtrl . CTabView gère tous les messages requis pour prendre en charge l’objet CMFCTabCtrl . Il vous suffit de dériver une classe et de CTabView la brancher dans votre application, puis d’ajouter CViewdes classes dérivées à l’aide de la AddView méthode. Le contrôle Onglet affiche ces affichages sous forme d’onglets.

Par exemple, vous pouvez avoir un document qui peut être représenté de différentes manières : en tant que feuille de calcul, graphique, formulaire modifiable, et ainsi de suite. Vous pouvez créer des vues individuelles dessinant les données selon les besoins, les insérer dans votre CTabViewobjet dérivé et les mettre sous forme de tabulation sans codage supplémentaire.

Exemple TabbedView : Application de vue tabulation MFC illustre l’utilisation de CTabView.

Exemple

L’exemple suivant montre comment CTabView utiliser l’exemple 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()
};

Spécifications

En-tête : afxTabView.h

CTabView ::AddView

Ajoute un affichage au contrôle Tab.

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

Paramètres

pViewClass
[in] Pointeur vers une classe runtime de la vue insérée.

strViewLabel
[in] Spécifie le texte de l’onglet.

iIndex
[in] Spécifie la position de base zéro à laquelle insérer la vue. Si la position est -1, le nouvel onglet est inséré à la fin.

pContext
[in] Pointeur vers la CCreateContext vue.

Valeur de retour

Index d’affichage si cette méthode réussit. Sinon, -1.

Notes

Appelez cette fonction pour ajouter une vue au contrôle tabulation incorporé dans un cadre.

CTabView ::FindTab

Retourne l’index de la vue spécifiée dans le contrôle Tab.

int FindTab(HWND hWndView) const;

Paramètres

hWndView
[in] Handle de la vue.

Valeur de retour

Index de la vue s’il est trouvé ; sinon, -1.

Notes

Appelez cette fonction pour récupérer l’index d’une vue qui a un handle spécifié.

CTabView ::GetActiveView

Retourne un pointeur vers l’affichage actif.

CView* GetActiveView() const;

Valeur de retour

Pointeur valide vers l’affichage actif ou NULL s’il n’y a pas d’affichage actif.

Notes

CTabView ::GetTabControl

Retourne une référence au contrôle Tab associé à la vue.

DECLARE_DYNCREATE CMFCTabCtrl& GetTabControl();

Valeur de retour

Référence au contrôle tabulation associé à la vue.

CTabView ::IsScrollBar

Appelé par l’infrastructure lors de la création d’un affichage onglet pour déterminer si l’affichage onglet a une barre de défilement horizontale partagée.

virtual BOOL IsScrollBar() const;

Valeur de retour

TRUE si l’affichage onglet doit être créé avec une barre de défilement partagée. Sinon, FALSE.

Notes

L’infrastructure appelle cette méthode lorsqu’un objet CTabView est en cours de création.

Remplacez la méthode IsScrollBar dans une classe dérivée de CTabView et retournez TRUE si vous souhaitez créer une vue avec une barre de défilement horizontale partagée.

CTabView ::OnActivateView

Appelé par l’infrastructure lorsque l’affichage onglet est rendu actif ou inactif.

virtual void OnActivateView(CView* view);

Paramètres

view
[in] Pointeur vers la vue.

Notes

L'implémentation par défaut n'exécute aucune opération. Substituez cette méthode dans une CTabViewclasse dérivée pour traiter cette notification.

CTabView ::RemoveView

Supprime l’affichage du contrôle Tab.

BOOL RemoveView(int iTabNum);

Paramètres

iTabNum
[in] Index de la vue à supprimer.

Valeur de retour

Index de la vue supprimée si cette méthode réussit. Sinon- -1.

Notes

CTabView ::SetActiveView

Active une vue.

BOOL SetActiveView(int iTabNum);

Paramètres

iTabNum
[in] Index de base zéro de l’affichage onglet.

Valeur de retour

TRUE si la vue spécifiée a été active, FALSE si l’index de la vue n’est pas valide.

Notes

Pour plus d’informations, consultez CMFCTabCtrl ::SetActiveTab.

Voir aussi

Graphique hiérarchique
Classes
CMFCTabCtrl
CView, classe