Click here to Skip to main content
Click here to Skip to main content
Go to top

A Tabbed MDI Frame Window

, 12 Mar 2008
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!

Comments and Discussions

 
GeneralHandly little piece of code -- plus small fix PinmemberJohn Slagel11-Mar-08 9:19 
GeneralRe: Handly little piece of code -- plus small fix PinmemberErnesto Perales Soto11-Mar-08 12:28 
QuestionHow to redraw views PinmemberVan Binh10-May-06 23:06 
AnswerRe: How to redraw views PinmemberErnesto Perales Soto11-May-06 3:42 
GeneralRe: How to redraw views PinmemberVan Binh17-May-06 22:51 
AnswerRe: How to redraw views PinmemberErnesto Perales Soto18-May-06 4:23 
Generalcan't capture mouse double click events. PinmemberDennis_Hu15-Dec-05 11:31 
AnswerRe: can't capture mouse double click events. PinmemberErnesto Perales Soto15-Dec-05 12:02 
GeneralRe: can't capture mouse double click events. PinmemberDennis_Hu16-Dec-05 8:35 
Generalit makes leaks Pinmembersakeani10-Jun-04 22:32 
GeneralAlternate solution PinmemberErnesto Perales Soto12-Jun-04 4:05 
GeneralRe: Alternate solution Pinmembersakeani13-Jun-04 15:51 
GeneralAnd right again! PinmemberErnesto Perales Soto14-Jun-04 19:36 
GeneralRe: And right again! PinmemberJabes15-Jun-04 1:18 
GeneralI stand corrected! PinmemberErnesto Perales Soto15-Jun-04 4:31 
GeneralVery cool ;) PinmemberKochise2-May-04 0:08 
GeneralThanks for sharing your links! PinmemberErnesto Perales Soto2-May-04 4:09 
GeneralNo Google skills... PinmemberKochise2-May-04 6:35 
GeneralRe: No Google skills... Pinmembersakeani13-Jun-04 15:48 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    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 | Mobile
Web04 | 2.8.140922.1 | Last Updated 12 Mar 2008
Article Copyright 2004 by Ernesto Perales Soto
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid