Click here to Skip to main content
12,623,027 members (30,329 online)
Click here to Skip to main content
Add your own
alternative version

Stats

100.8K views
2.7K downloads
32 bookmarked
Posted

A Tabbed MDI Frame Window

, 12 Mar 2008 CPOL
Rate this:
Please Sign up or sign in to vote.
A tabbed frame window to show several views of a document in a single frame.
Sample Image - screenshot.png

Introduction

In a recent project, I wanted to show the document data using different views. I didn't like the default MFC implementation, creating a new frame window for each view.

I headed to Code Project and found several tabbed window articles (Property Sheet View, A Multi Document Tabbed Interface, etc.) but none was exactly what I needed: one frame per document, and one tab per view. With a little help from Google, I found an old article at CodeGuru named "Tabbed Views" by Salvatore Mosaico. I took the original idea, removed the grouping feature, and created this class, adding support for another feature I needed: tool bars and status bars in the child frame.

Using the Code

  • Derive a new class from CTabbedMDIChildWnd. If you do this by hand, remember to define the message map and dynamic creation. You can use the class wizard to do the dirty work for you.
    • Select a new MFC class:

    • Choose CMDIChildWnd as the base class:

    • And replace all occurrences of CMDIChildWnd with our class. Do this both in the *.h and *.cpp files:

    • Don't forget to include the CTabbedMDIChildWnd header in the *.h.
      #include <span class="code-string">"TabbedMDIChildWnd.h"</span>
  • Include the header files of your views:
    #include <span class="code-string">"FirstView.h"</span>
    #include <span class="code-string">"SecondView.h"</span>
  • To tell the frame window which tabs to use, use the helper class CTabbedMDIChildWnd::CTabItem. This class is derived form TCITEM, with the addition of a CRuntimeClass to create the view. You can use the provided constructor as in the next example.
  • Override OnCreateClient. Inside the function, define the tabs, and call the base class:
    BOOL CDemoChildWnd::OnCreateClient(LPCREATESTRUCT lpcs, 
                                       CCreateContext* pContext)
    {
        // this is the heart of the class, each call to DefineView will
        // add a tab of the specified class
        DefineTab(CTabbedMDIChildWnd::CTabItem(_T("First View"),
                                       RUNTIME_CLASS(CFirstView)));
        DefineTab(CTabbedMDIChildWnd::CTabItem(_T("Second View"),
                                      RUNTIME_CLASS(CSecondView)));
        return CTabbedMDIChildWnd::OnCreateClient(lpcs,pContext);
    }
  • Your class in now ready. It is a good time to compile the project!
  • The next step is to change the MDI child frame inside the InitInstance function of the application:
    // Register the application's document templates.  Document templates
    //  serve as the connection between documents, frame windows and views
    CMultiDocTemplate* pDocTemplate;
    pDocTemplate = new CMultiDocTemplate(IDR_TabbedFrameTYPE,
        RUNTIME_CLASS(CTabbedFrameDoc),
        RUNTIME_CLASS(CDemoChildWnd), // custom MDI child frame
        RUNTIME_CLASS(CTabbedFrameView));
    AddDocTemplate(pDocTemplate);
    

Inside the Class

The class has a CTabCtrl member and creates one tab for each view defined by a call to DefineTab. It handles the TCN_SELCHANGE and TCN_SELCHANGING notify messages to hide and show the views as the tabs are selected.

It uses a std::vector to keep track of the defined tabs using the runtime class of the different views. This implementation imposes a limitation, only one instance of a view class is supported. Calling DefineTab several times using the same runtime class is not a good idea!

If you want to change the appearance of the tab control, you can customize CTabbedMDIChildWnd::OnCreateClient to change the styles of the tab control, or make additional calls to add images, etc.

History

  • 1.1 Fixed small memory leak (thanks to J.H.Park)
  • 12th March, 2008: Updated downloads

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Ernesto Perales Soto
Web Developer
Mexico Mexico
@Work : Doing UML modelling for food
@Home : Still coding for fun!

You may also be interested in...

Comments and Discussions

 
GeneralHandly little piece of code -- plus small fix Pin
John Slagel11-Mar-08 10:19
memberJohn Slagel11-Mar-08 10:19 
GeneralRe: Handly little piece of code -- plus small fix Pin
Ernesto Perales Soto11-Mar-08 13:28
memberErnesto Perales Soto11-Mar-08 13:28 
QuestionHow to redraw views Pin
Van Binh11-May-06 0:06
memberVan Binh11-May-06 0:06 
AnswerRe: How to redraw views Pin
Ernesto Perales Soto11-May-06 4:42
memberErnesto Perales Soto11-May-06 4:42 
GeneralRe: How to redraw views Pin
Van Binh17-May-06 23:51
memberVan Binh17-May-06 23:51 
AnswerRe: How to redraw views Pin
Ernesto Perales Soto18-May-06 5:23
memberErnesto Perales Soto18-May-06 5:23 
Generalcan't capture mouse double click events. Pin
Dennis_Hu15-Dec-05 12:31
memberDennis_Hu15-Dec-05 12:31 
AnswerRe: can't capture mouse double click events. Pin
Ernesto Perales Soto15-Dec-05 13:02
memberErnesto Perales Soto15-Dec-05 13:02 
GeneralRe: can't capture mouse double click events. Pin
Dennis_Hu16-Dec-05 9:35
memberDennis_Hu16-Dec-05 9:35 
Generalit makes leaks Pin
sakeani10-Jun-04 23:32
membersakeani10-Jun-04 23:32 
GeneralAlternate solution Pin
Ernesto Perales Soto12-Jun-04 5:05
memberErnesto Perales Soto12-Jun-04 5:05 
GeneralRe: Alternate solution Pin
sakeani13-Jun-04 16:51
membersakeani13-Jun-04 16:51 
GeneralAnd right again! Pin
Ernesto Perales Soto14-Jun-04 20:36
memberErnesto Perales Soto14-Jun-04 20:36 
GeneralRe: And right again! Pin
Jabes15-Jun-04 2:18
memberJabes15-Jun-04 2:18 
GeneralI stand corrected! Pin
Ernesto Perales Soto15-Jun-04 5:31
memberErnesto Perales Soto15-Jun-04 5:31 
GeneralVery cool ;) Pin
Kochise2-May-04 1:08
memberKochise2-May-04 1:08 
GeneralThanks for sharing your links! Pin
Ernesto Perales Soto2-May-04 5:09
memberErnesto Perales Soto2-May-04 5:09 
GeneralNo Google skills... Pin
Kochise2-May-04 7:35
memberKochise2-May-04 7:35 
GeneralRe: No Google skills... Pin
sakeani13-Jun-04 16:48
membersakeani13-Jun-04 16:48 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.161128.1 | Last Updated 12 Mar 2008
Article Copyright 2004 by Ernesto Perales Soto
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid