Click here to Skip to main content
15,867,308 members
Articles / Programming Languages / C#

Creating MDI application using C# (Walkthrough)

Rate me:
Please Sign up or sign in to vote.
3.20/5 (38 votes)
29 Jun 2004CPOL6 min read 319.6K   8.9K   51   30
If you are a beginner(or intermediate) and want to develop an MDI application in C# then this one is for you!!

Sample Image - myBestMDI.jpg

Introduction

MDI (Multiple Document Interface) is nothing but a way of displaying windows form where there is atleast one parent and many child windows eg. word Excel Powerpoint kind of windows where each document , sheet or slide act as a child under the parent container window. SDI(Single document Interface) examples are Windows Explorer,Internet explorer,Notepad etc...where only one window acts as an interface. If you are a beginner(or intermediate) and want to develop an MDI application with basic functionality using the powerful C# language checkout the following step-by-step guide to develop. Even people coming from VB6 background face lots of problem because of the pure OOPs usage in C#. Follow this small step by step walkthrough to make a small MDI application.

Step by Step Walkthrough

  1. Goto File->New->Blank Solution
  2. Select Visual C# Projects in Project Types
  3. Select WindowsApplication in Templates
  4. Type for eg. myBestMDI in the Name textbox
  5. By Clicking the browse button select the location & Click OK

Creating All the Necessary Forms & Coding Them

Creating the Main MDI Form(frmMDIMain) to Act as a Container

  1. In the View->Solution Explorer click Form1 only once
  2. Locate the property FileName and type "frmMDIMain.cs"
  3. In the Solution Explorer now doubleclick frmMDIMain
  4. Locate the property (Name) and type "frmMDIMain"
  5. Locate the property Text and type "This is the Parent"
  6. Locate the property IsMDIContainer and set it to true
  7. Locate the property WindowState and set it to Maximized

Creating the Child form (frmMChild) to Demonstrate Multiple Instance

  1. Goto Project Menu-Add Windows Forms & type frmMChild
  2. In the Solution Explorer now doubleclick frmMChild
  3. Locate the property Text and type "This is the Multi Instance Child"
  4. Locate the property size & set it to 568, 464

Creating the Child Form (frmSChild) to Demonstrate Single Instance

  1. Goto Project Menu-Add Windows Forms & type frmSChild
  2. In the Solution Explorer now doubleclick frmSChild
  3. Locate the property Text and type "This is the Single Instance Child"
  4. Locate the property size & set it to 568, 464\

Creating the About form (frmAbout) to Give Information About this Product

  1. Goto Project Menu-Add Windows Forms & type frmAbout
  2. In the Solution Explorer now doubleclick frmAbout
  3. Locate the property Text and type "About My Best MDI"
  4. Locate the property size & set it to 448, 304
  5. Locate the property FormBorderstyle & set it to FixedToolWindow

Creating the Splash form (frmSplash) to Display the Welcome Information with Company Logo

  1. Goto Project Menu-Add Windows Forms & type frmSplash
  2. In the Solution Explorer now doubleclick frmSplash
  3. Locate the property size and set it to 448, 320
  4. Locate the property ControlBox and set it to False
  5. Locate the property FormBoderStyle and set it to None
  6. Locate the property StartupPosition and set it to CenterScreen
  7. Locate the property BackGroundImage and browse a nice image along with your company logo
  8. Locate the property cursor & set it to waitCursor

Adding a Timer Control to the Splash Screen for Holding it for Few Seconds so that the User Can Read It

  1. Goto View->Toolbox and Double click Timer control
  2. Locate timer1 control & click it once
  3. Set its Interval property to 2000 i.e. in milliseconds
  4. Set its Enabled property to true
  5. Double click to reach its Tick event
type :- 
timer1.Enabled = false;
this.Close();

Adding two classes 1 to Act as the Main Startup Class(clsMain) & 1 for Holding Global Objects(clsGlobal)

  1. In the Solution explorer right click the Project Name myBestMdi
  2. Click Add->New Folder and type classes
  3. right click the Folder classes
  4. Click Add->Add New Item and class and type clsGlobal in name

    Note: myBestMDI.Classes is automatically taken as the namespace due to folder level

  5. change the modifiers for the class from
     public class clsGlobal 
    to
    public sealed class clsGlobal
    

    (This is to protect an instantiation of this class)

  6. Just after the curly braces of the class starts paste the following line
    public static frmMDIMain g_objfrmMDIMain;
    //this is to declare a global static reference to our MDI parent so that the same 
    //instance is referred across all child with no extra line of code
  7. Again in the Solution explorer right click the Folder classes
  8. Click Add->Add New Item and class and type clsMain in name
  9. just below the constructor clsMain function in the clsMain class paste the following snippet
    [STAThread]
      static void Main() 
      {
       try
       {
        frmSplash objfrmSplash = new frmSplash();
        objfrmSplash.ShowDialog();
        clsGlobal.g_objfrmMDIMain = new frmMDIMain();
        Application.Run(clsGlobal.g_objfrmMDIMain);
       }
       catch(Exception ex)
       {
        MessageBox.Show(ex.Message,"My Best MDI",
         MessageBoxButtons.OK,MessageBoxIcon.Stop);            
       }
      }
    //This is the Single Threaded Apartment Model(out of our scope)
    //of the application which will run the Main function
    //when the application starts
  10. Since we are using Application class and MessageBox functions in the above code we need a add the foolowing line on the top using System.Windows.Forms;
  11. Now go to frmMain now and from its code window remove the following piece of code
[STAThread]
  static void Main() 
  {
   Application.Run(new Form1());
  }
//because we cannot have two Main function.We are invoking everything from clsMain

Creating Menus in the main MDI Form

  1. Click View->Designer of frmMdiMain
  2. Goto Toolbox and add a double click MainMenu control
  3. Click once on the typehere menu
  4. Locate the property Name & set it to mnuFile
  5. Locate the property Text & set it to &File

    Note: & is for underscore which will enable the Hot key 'F'

  6. Same way click on the sub menu TypeHere box
  7. Locate the property Name & set it to mnuFileNewMultiple
  8. Locate the property Text & set it to &New Multiple
  9. Locate the property ShortCut & choose CtrlN
  10. Same way click on the sub menu TypeHere box
  11. Locate the property Name & set it to mnuFileNewSingle
  12. Locate the property Text & set it to New &Single
  13. click on the sub menu TypeHere box
  14. Locate the property Name & set it to mnuFileCloseChild
  15. Locate the property Text & set it to &Close Child
  16. click on the sub menu TypeHere box
  17. Locate the property Name & set it to mnuFileSep1
  18. Locate the property Text & set it to -

    Note - is a hyphen which will automatically put a whole seperator

  19. click on the sub menu TypeHere box
  20. Locate the property Name & set it to mnuFileExit
  21. Locate the property Text & set it to E&xit

    Now I am sure by now you should be able to create one more menu

  22. Create one more top level menu with Name mnuWindow and text &Window set its MDIList property to true(will show names of opened windows) with 3 sub menus with name
    mnuWindowCascade and text &Cascade
    mnuWindowTileVertical and text Tile&Vertical
    mnuWindowTileHorizontal and text Tile&Horizontal
  23. Create one more top level menu with Name mnuHelp and text &Help with a sub menu with name mnuHelpAbout and text &About... '...' as the suffix is just a Microsoft convention to signify that the command will show a dialog box.

Putting Life in the Menus Created by Adding Code to It

  1. Now in the frmSChild code add the following lines
    C#
      private static frmSChild m_SChildform;
      public static frmSChild GetChildInstance()
      {
       if (m_SChildform ==null) //if not created yet, Create an instance
        m_SChildform = new frmSChild();
       return m_SChildform;  //just created or created earlier.Return it
      }
    
    //This is to make sure that when we Click on a 'New Single' menu on Parent form twice 
    //it should not open two instance of the same child form
  2. Click View->Designer of frmMdiMain again
  3. Double click New Single Menu on MDI main form

    add the following code

    C#
    frmSChild objfrmSChild = frmSChild.GetChildInstance();
    objfrmSChild.MdiParent = this;
    objfrmSChild.Show();
    objfrmSChild.BringToFront();
  4. Click View->Designer of frmMdiMain again
  5. Double click New Multi Menu on MDI main form

    add the following code

    frmMChild objfrmMChild = new frmMChild();
    objfrmMChild.MdiParent = this;
    objfrmMChild.Show();
  6. Double click CloseChild on MDI main form add the following code
    C#
    try
    {
     if(this.ActiveMdiChild.Name =="frmMChild")
     {
      frmMChild objfrmMChild = (frmMChild)this.ActiveMdiChild;
      objfrmMChild.Close();
     }
     else
     {
      frmSChild objfrmSChild = (frmSChild)this.ActiveMdiChild;
      objfrmSChild.Close();
    
     }
    }
    catch
    {
    }
  7. Double click Exit on MDI main form add the following code
    Application.Exit(); 
  8. Double click Cascade menu under Windows on MDI main form add the following code
    this.LayoutMdi(MdiLayout.Cascade);
  9. same way for tile Vertical add
    this.LayoutMdi(MdiLayout.TileVertical);
  10. and for tile horizontal add
    this.LayoutMdi(MdiLayout.TileHorizontal);
  11. Now finally double click About menu in Help to add
    frmAbout objfrmAbout = new frmAbout();
    objfrmAbout.ShowDialog();
  12. Press F5 to start with debugging or Ctrl+F5 to start w/o debugging

Sample screenshot

Enjoy programming!!

License

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


Written By
Instructor / Trainer
India India
Irfan Patel is a Bachelor of Computer Application
He holds a MCSD, MCP.NET, ITIL Certifications and has worked extensively with C#, ASP.Net, SQL Server since 1998.
He has also trained various programming languages and tools, RDBMS & OS platforms to more than 1000 students.

His expertise comes from various industries viz Jewellery, Shipping ,Automobiles , RFID projects, Ticket Reservation systems and e-commerce websites.

Besides teaching and programming he loves music, singing, dancing, bikes & following his favourite football team Chelsea.

Comments and Discussions

 
QuestionIf Click two time on Single Pin
Member 112658376-Jan-16 0:10
Member 112658376-Jan-16 0:10 
Questionthanks Pin
Laura7515-Dec-13 2:56
Laura7515-Dec-13 2:56 
Thank you for the article and the example! It helped me very much! Smile | :)
GeneralMy vote of 5 Pin
Ian Drew4-Feb-13 0:17
Ian Drew4-Feb-13 0:17 
GeneralMy vote of 3 Pin
Ali Agha25-Jan-13 12:23
Ali Agha25-Jan-13 12:23 
GeneralGreat tutorial - Here are some bug fixes Pin
Jean-LucTallis31-Dec-12 7:21
Jean-LucTallis31-Dec-12 7:21 
GeneralRe: Great tutorial - Here are some bug fixes Pin
Ciorbea21-Aug-13 4:54
Ciorbea21-Aug-13 4:54 
GeneralMy vote of 3 Pin
Kshitiz Chandra17-Aug-12 17:30
Kshitiz Chandra17-Aug-12 17:30 
GeneralMy vote of 5 Pin
battzion14-Aug-12 21:15
battzion14-Aug-12 21:15 
GeneralMy vote of 5 Pin
Member 432084410-Feb-12 5:33
Member 432084410-Feb-12 5:33 
QuestionAdaptations in newer versions of Visual C# Pin
harryjansens19-Jun-11 5:01
harryjansens19-Jun-11 5:01 
Questionwhen i tried this codes.... an error " Cannot access a disposed object. Object name: 'frmSChild...:" this happens when i select "new single" from "File" menu Second time.. Pin
Ragi Gopi3-Jun-11 21:19
Ragi Gopi3-Jun-11 21:19 
GeneralMy vote of 5 Pin
elTorito6667-Apr-11 5:01
elTorito6667-Apr-11 5:01 
Generalcannot set startup object to "Main" class Pin
vegeta4ss15-Jan-10 13:10
vegeta4ss15-Jan-10 13:10 
Questionto get the mdichild form's richtextbox contents and store it in mdiparent Pin
brindhakr9-May-09 2:11
brindhakr9-May-09 2:11 
Generalnever mind I found the AllowMerge property Pin
ThorTheBraveGod14-Apr-09 9:59
ThorTheBraveGod14-Apr-09 9:59 
GeneralMenu in the multi forms Pin
ThorTheBraveGod14-Apr-09 9:36
ThorTheBraveGod14-Apr-09 9:36 
Generalthanx Pin
kanza azhar29-Nov-08 9:50
kanza azhar29-Nov-08 9:50 
GeneralERROR when closing single child and re-open it Pin
TheCubanP18-Dec-06 10:51
TheCubanP18-Dec-06 10:51 
GeneralRe: ERROR when closing single child and re-open it Pin
Martyn J Jones14-Jun-07 1:41
Martyn J Jones14-Jun-07 1:41 
QuestionNaming Conventions and Standards? Pin
User 244981521-Sep-06 12:56
User 244981521-Sep-06 12:56 
GeneralError Pin
airfatter27-Jun-06 23:33
airfatter27-Jun-06 23:33 
GeneralRe: Error Pin
Ent194-Oct-06 2:58
Ent194-Oct-06 2:58 
Questionclose all child window Pin
parivartan12-Jan-06 22:30
parivartan12-Jan-06 22:30 
AnswerRe: close all child window Pin
dapoussin4-Apr-06 3:36
dapoussin4-Apr-06 3:36 
GeneralMultiple child Pin
Anonymous12-May-05 18:13
Anonymous12-May-05 18:13 

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.