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.