Click here to Skip to main content
Click here to Skip to main content

Creating your first MFC Doc/View application

By , 10 Sep 2000
Rate this:
Please Sign up or sign in to vote.
<!-- Download Links -->
  • Download demo SDI application - 26 Kb
  • Download demo MDI application - 28 Kb
  • <!-- Main HTML starts here -->

    Introduction

    Creating applications using the MFC document/view architecture can save time, can help you create more structured programs, and can also help alleviate a lot of tedious boilerplate coding that you may otherwise be forced to write. It can, however, force you to structure your applications in a way that doesn't quite fit the problem you are trying to solve (such as games), and it does also mean you are forced to carry the overhead of using the MFC runtime libraries. If you are sure that your user will have the version of MFC already installed, or you don't mind including it in a setup program, and you don't mind an executable that is a touch larger than an equivalent win32/SDK version then MFC can save you a lot of time.

    The doc/view architecture that is mentioned a lot in MFC literature simply refers to the practice of separating your appplications data storage and minipulation logic from the data visualisation logic. Basically, you have a CDocument derived class to load, manipulate and store your data, and a CView derived class to display the data. Your document and view classes (you can have multiple document and multiple view classes within a single app) are linked together using internal MFC classes by your main application's (CWinApp derived) class, and physically managed on the screen by a Main Frame (CFrameWnd or CMDIChildWnd derived) class.

    In Single Document Interface (SDI) applications, there is one CFrameWnd class and and one view. Each time a document is loaded the view is cleared and redrawn using the information in the new document. The view is essentially reused.

    The image below shows a typical SDI application. The main window contains the menu, toolbar, status bar, and the view window. The menus, toolbar, status bar are created and owned by the CFrameWnd class. You can create entire applications without having to touch the frame class at all.

    The CView class has, as its display area, the dotted section shown in the image. Everytime that area needs repainting the class' OnDraw method will be called, and the view will be expected to query it's associated document so it knows what to draw.

    In Multiple Document Interface (MDI) applications there is one main frame per application (in this case a CMDIFrameWnd, and one CMDIChildWnd derived child frame for each document.

    Each time a new document is opened a new CMDIChildWnd is created that lives inside the main applications CMDIFrameWnd window. The main frame window contains and owns the menus, toolbars and status bar, and each CMDIChildWnd window contains a view window. When you switch between different child frames the main frame automatically updates the menu and toolbars to match that associated with the current view inside the child frame.

    In Visual Studio .NET there is a third option that creates a new CFrameWnd each time a new document is opened. This option won't be covered here yet.

    It's important to note that each view can only be associated with one document and one frame window. A CMDIFrameWnd window contains zero or more CMDIChildWnd windows, and each CFrameWnd or CMDIChildWnd contains one CView window. However, each document can have more than one view associated with it. A typical example is the case of a splitter window that can be split to show two different views of the same document.

    Creating an application

    Creating an MFC doc/view application is very simple. Fire up the AppWizard (File | New...) and follow along.

    First we select the MFC AppWizard.

    Choose either MDI or SDI (dialog based have been covered elsewhere) and click Next until you hit step 4.

    This step allows you to customise a bunch of stuff including toolbars, menus, status bar and print preview. Check the boxes and you get all this for free! One important step here is the "Advanced" button. This allows you to specify a file extension that your application will open by default - and which the Windows Shell will associate with your application should the user double click on a file of that type.

    Here I've simple entered "my" as my file extension. Once the program is compiled and run for the first time, all .my files will have the icon specified by the IDR_MYSDIATYPE resource (the actual resource name will obviously change with the name of your application).

    Continue clicking Next and you will come to the final step that allows you to choose the type of view you want. MFC provides a ton of different CView derived types to make life easier, including HTML viewers, scrolling views, views that wrap common controls and a dialog-type Form view.

    Once the wizard has finished you have an application that can be compiled and run immediately. It won't do anything useful, but in a way it already does a lot: toolbars, status bars, menu, printing and print preview and file type registration. All that remains is for you to fill in the details of your document (Serialize will load and save documents, OnNewDocument will be called to create a new document), and your view (OnDraw to do the drawing, and OnInitialUpdate for initialising variables when the view is first created).

    To customise the menus, icons and toolbars simply use the resource editors provided with Visual Studio. Life doesn't get any easier.

    Further Reading

    For further tutorials, check out

    License

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

    About the Author

    Chris Maunder
    Founder CodeProject
    Canada Canada
    Chris is the Co-founder, Administrator, Architect, Chief Editor and Shameless Hack who wrote and runs The Code Project. He's been programming since 1988 while pretending to be, in various guises, an astrophysicist, mathematician, physicist, hydrologist, geomorphologist, defence intelligence researcher and then, when all that got a bit rough on the nerves, a web developer. He is a Microsoft Visual C++ MVP both globally and for Canada locally.
     
    His programming experience includes C/C++, C#, SQL, MFC, ASP, ASP.NET, and far, far too much FORTRAN. He has worked on PocketPCs, AIX mainframes, Sun workstations, and a CRAY YMP C90 behemoth but finds notebooks take up less desk space.
     
    He dodges, he weaves, and he never gets enough sleep. He is kind to small animals.
     
    Chris was born and bred in Australia but splits his time between Toronto and Melbourne, depending on the weather. For relaxation he is into road cycling, snowboarding, rock climbing, and storm chasing.
    Follow on   Twitter   Google+   LinkedIn

    Comments and Discussions

     
    GeneralCool - still 'Featuring' after a decade! PinmemberKyudos4-Nov-10 11:35 
    QuestionChanging the Application name in SDI PinmemberAVIHAR2-Dec-08 1:33 
    QuestionMDI New Document [modified] PinmemberAllAtSea26-Aug-07 23:29 
    GeneralCButton Placement PinmemberWalt Austin9-Apr-07 15:59 
    QuestionSerialize to certain file type PinmemberN-O-R-B-E-R-T5-May-06 3:00 
    Questiontwo MDI frame windows in a single mdi app or two frame windows in single sdi app? Pinmemberv_srinu_26_f17-Feb-06 3:25 
    AnswerRe: two MDI frame windows in a single mdi app or two frame windows in single sdi app? Pinmemberv_srinu_26_f17-Feb-06 4:50 
    Questionhow to show two different rtf file in a single window PinmemberGnanaprakashJebaraj28-Jun-05 4:10 
    GeneralQuestion Please Help Pinmemberedwardking2-Jan-04 1:55 
    Generaltaaaatataaa PinsussAnonymous29-Dec-03 4:52 
    GeneralMDI / SDI in a dialog based Application PinmemberVictor Paraschiv28-Oct-03 22:05 
    GeneralOne Document and two views PinmemberMuhammadAsifJavaid21-Jun-03 0:42 
    QuestionWhat the @#$%^&amp;* PinsussAnonymous23-May-03 9:20 
    AnswerRe: What the @#$%^&amp;* PinadminChris Maunder23-May-03 9:31 
    QuestionHow do I specify CView's size? PinsussAnonymous15-Dec-02 10:25 
    AnswerRe: How do I specify CView's size? PinmemberRobbie sun15-Oct-04 1:57 
    Questionam I stupide ? PinsussAnonymous7-Sep-02 3:17 
    AnswerRe: am I stupide ? PineditorBrian Delahunty20-Oct-02 3:02 
    AnswerRe: am I stupide ? PinmemberBalkrishna Talele18-Dec-03 18:56 
    Questionserialize? PinmemberDuffman23414-Aug-02 17:58 
    AnswerRe: serialize? PinmemberXink22-Dec-03 5:00 
    GeneralThanks! ... but Pinmemberrbc22-Apr-02 7:06 
    GeneralMultiple Views with one Document Pinmemberakraus1-Oct-01 3:57 
    GeneralRe: Multiple Views with one Document PinsussAnonymous1-Jun-05 20:14 
    GeneralImporting existing dialog interfaces into a new SDI application. PinmemberKimball M. Rudeen27-May-01 9:50 

    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
    Web03 | 2.8.140415.2 | Last Updated 11 Sep 2000
    Article Copyright 2000 by Chris Maunder
    Everything else Copyright © CodeProject, 1999-2014
    Terms of Use
    Layout: fixed | fluid