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

SDI with split window

, 1 Jan 2007
Rate this:
Please Sign up or sign in to vote.
Create an SDI with split window without all the extra garbage of the Doc/View architecture.

Sample Image - SplitWindow.jpg

Introduction

Have you ever wanted to use a split window in you program but didn’t want all the extra garbage of the Doc/View architecture?

In the new project wizard, in order to make the “Split Window” check box available, you have to choose “Document/View architecture support”. This puts a lot of extra unneeded code in your project if all you wanted was a split main window.

In this article, I am going to walk you through creating a simple SDI with a split main window, a tool bar, and status bar. The window will be split into a left and right pane that are resource based and can be modified easily in the resource editor just like making a simple dialog based application.

These instructions and project files are for Visual Studio 2005; while they may work in older versions of Visual Studio, you’ll be on your own to adapt them.

Start Visual Studio and create a new project. Select MFC application, give your project a name, and click “OK”.

Click Next.

In order to keep this as simple as possible, we will use minimal options for our project.

Choose “Single document”, uncheck “Document/View architecture”, uncheck “Use Unicode libraries”, and select “Use MFC in static library”. Click Next.

We don’t want any database support, so just click Next.

On this page, we will keep the defaults. This will give us a status bar and a tool bar. Nice things to have in an SDI project. Hit Next.

Uncheck “ActiveX controls” and “Common Control Manifest”; unless you know you are going to be using ActiveX controls and the new XP specific controls in your project, there is no reason for the extra overhead. Hit Next.

Here is where it would be nice if they let us choose what kind of child view we want, but they don’t, so just hit Finish.

Compile and run the project.

Notice that the icon on the title bar is set to a default icon instead of the one defined in the project's resource file. This is a bug in Visual studio that’s been around for years. Here’s how to fix it.

In the IDE, select the class view and double click on “InitInstance”.

You should see:

To change the icon on the title bar, first we need to create one, then we need to tell the main application window to use it. Place the following code after the “UpdateWindow” but before the “return”.

//Create and load the titlebar icon
HICON hIcon;
hIcon = LoadIcon(IDR_MAINFRAME);    
AfxGetMainWnd()->SendMessage(WM_SETICON,TRUE,(LPARAM)hIcon);

Contrary to what you might think, LoadIcon doesn’t actually load the icon, it just creates it. We have to tell the application to use the new icon with a SendMessage.

Your “InitInstance” should now look like this:

Now when you compile and run, you should see the resource defined icon on the title bar.

You can now use the resource editor to change the icon to whatever you want.

Now it is time to add the split window I promised. In order to have a split window, we will use a class called CSplitterWnd. In the class view, right click on CMainFrame and select “Add Variable”. Change the access to “Protected”, the variable type to “CSplitterWnd”, and the variable name to “m_wndSplitter”, and click Finish.

Since the split will be in the client area, the code for it will need to be in an override function called OnCreateClient in CMainFrame.

In the class view, select CMainFrame. In the properties area, press the “Overrides” button and scroll down to “OnCreateClient” and add the function with the combo box to the right.

Add the following code to the OnCreateClient function:

// create splitter window
if (!m_wndSplitter.CreateStatic(this, 1, 2))
    return FALSE;

This will create a static split window for us that will have one row and two columns.

But wait, don’t compile yet. We still need to tell the splitter what to display in each pane and we need to get rid of the old view Visual Studio created for us.

For this tutorial, let us use resource based forms. That will make it easy to add controls and use this project as a template for building other applications.

Switch to Resource view, expand the dialog leaf, right click and choose “Insert Dialog”. This will insert a new dialog resource and open it in the resource editor.

Delete the “OK” and “Cancel” buttons. Right click on the dialog and choose Properties.

In Properties, change:

  • Border to “None”.
  • Control to “True”.
  • ID to “IDD_FORM_LEFT”.
  • Style to “Child”.

Now add a new dialog in the same manner but make the ID: IDD_FORM_RIGHT.

In the resource view, double click IDD_FORM_LEFT. This will open up the left form in the resource editor. Right click on the dialog in the editor and choose “Add Class”.

Change the base class to “CFormView”, the name to “CFormLeft”, and hit Finish.

Repeat this process on the IDD_FORM_RIGHT resource but make the class name CFormRight.

Now we have views for the splitter to display.

In MainFrm.cpp, add the header lines:

#include "FormLeft.h"
#include "FormRight.h"

Scroll down to the “OnCreateClient” function and add the create view calls to the splitter. Add the following code after the splitter creation, but before the return.

if (!m_wndSplitter.CreateView(0, 0, RUNTIME_CLASS(CFormLeft), CSize(125, 100), pContext) ||
    !m_wndSplitter.CreateView(0, 1, RUNTIME_CLASS(CFormRight), CSize(100, 100), pContext))
{
    m_wndSplitter.DestroyWindow();
    return FALSE;
}

Your OnCreateClient should look like this.

We’re almost there. Now we need to get rid of the View Visual Studio made for us and any uses of the old view.

Scroll up to the OnCmdMsg function and remove:

if (m_wndView.OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
    return TRUE;

Scroll up to the OnSetFocus function and remove:

m_wndView.SetFocus();

Scroll up to the OnCreate function and remove:

// create a view to occupy the client area of the frame
if (!m_wndView.Create(NULL, NULL, AFX_WS_DEFAULT_VIEW,
    CRect(0, 0, 0, 0), this, AFX_IDW_PANE_FIRST, NULL))
{
    TRACE0("Failed to create view window\n");
    return -1;
}

At the top of MainFrm.h, remove:

#include "ChildView.h"

Scroll down and remove:

CChildView    m_wndView;

Switch to Solution Explorer, right click on “ChildView.h”, and choose Remove. On the pop up box, press the Delete button.

Delete “ChildView.cpp” in the same manner.

You can compile and run now, and you will have an SDI with a split window. Try it out, drag the split bar around:

It doesn’t do anything at this point, but you can add controls with the resource editor.

However, the controls in each pane can only affect controls in the same pane. In order to have controls in the left pane affect controls in the right pane, we will need to reroute some messages.

In the class view, right click on “CformLeft” and choose “Add variable”. Make the access protected, the type “CWnd*”, and the name “m_target”. Hit Finish.

In the class view, right click on “CFormLeft” and choose “Add function”. Make the return type void, the name “SetTarget”, and add a parameter of type “CWnd*” named “m_cwnd”. Hit Finish.

In the SetTarget function, add the code:

m_target = m_cwnd;

You should see:

Next we will need to override the OnCommand function. Select “CFormLeft” in the class view. Click the Overrides button and scroll down to OnCommand and use the dropdown box to add the function.

In the OnCommand function, add the following code:

if(m_target)
{           
    m_target->SendMessage(WM_COMMAND, wParam, lParam);
}
else
{
    CFormView::OnCommand(wParam, lParam);
}
return true;

You should see:

This will send the messages from this form to the target window we set. Now we want to set the target to the form in the right pane.

Add the following code to the OnCreateClient function in CMainFrame after the splitter creates views and before the return:

//set the target for mapped messages
((CFormLeft*)m_wndSplitter.GetPane(0,0))->SetTarget(m_wndSplitter.GetPane(0,1));

Your function should now look like:

Now let's add some controls and use it. Open IDD_FORM_RIGHT in the resource editor and add a static text control.

Change the ID to IDC_STATIC_HELLO, the caption to “Click the button”, and the text align to Center.

Right click on the static control and choose Add Variable. Click the control type check box, the type “CStatic”, and the name “m_hello”. Click Finish.

Open IDD_FORM_LEFT in the resource editor and add a button.

Change the ID to IDC_BUTTON_HELLO and the caption to “Say Hello”.

Right click on the button and choose “Add Event Handler”. Select message type BN_CLICKED and “CFormRight” from the class list, then hit Add and Edit.

In the OnBnClickedButtonHello function, add the following code:

m_hello.SetWindowText("Hello Window Splitter!");

Your function should look like:

Compile and run your program. Click the Say Hello button and you should see the test change in the right pane. Now try dragging the split bar and you should see the text in the right pane move with the splitter bar.

I hope you found this article useful.

License

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

Share

About the Author

kencocomputers
Software Developer (Senior)
United States United States
I am a contract developer of windows based software written in C++.

Comments and Discussions

 
GeneralMy vote of 5 PinprofessionalHanker.Dong26-Apr-13 17:06 
GeneralMy vote of 5 Pinmembershetkarabhijeet14-Nov-12 20:04 
Generalthanks Pinmembervinaypeepl27-Aug-12 22:47 
QuestionProblem with panes PinmemberMember 848486321-Aug-12 22:57 
QuestionHelp me pls... PinmemberMember 848486321-Aug-12 22:35 
QuestionSend message Pinmembersc9311-Jun-12 3:44 
GeneralMy vote of 5 Pinmemberxmbfd14-Feb-12 23:24 
GeneralMy vote of 5 Pinmemberneuodpo3-Aug-11 22:56 
QuestionHow to implement this sample with VC6.0 ? Pinmemberneuodpo2-Aug-11 21:29 
AnswerRe: How to implement this sample with VC6.0 ? Pinmemberneuodpo2-Aug-11 23:14 
GeneralMy vote of 5 PinmemberDai Yan26-Apr-11 16:47 
Easy understand!I like it!
GeneralMy vote of 5 PinmemberMember 778626531-Mar-11 18:43 
GeneralThanks a lot PinmemberMember 77406709-Mar-11 15:48 
GeneralMy vote of 5 PinmemberAntonio Pedone19-Feb-11 10:02 
Generalhelp reqd on my split wnd [modified] Pinmemberashwani_gupt28-Dec-10 21:53 
GeneralRe: help reqd on my split wnd Pinmemberashwani_gupt29-Dec-10 0:04 
GeneralMy vote of 5 Pinmemberhiddensoul26-Dec-10 8:58 
GeneralMy vote of 5 PinmemberStoreThick_StartThin15-Dec-10 21:35 
Generalthanks Pinmemberfanliu9-Nov-09 21:36 
GeneralVery Useful PinmemberKinjalMansi1-Nov-09 19:06 
QuestionAbout Splitter Position - Move to Center PinmemberMember 343239822-Jun-09 22:34 
AnswerRe: About Splitter Position - Move to Center Pinmemberkencocomputers23-Jun-09 5:22 
GeneralRe: About Splitter Position - Move to Center [modified] PinmemberMember 343239824-Jun-09 2:13 
Generalawesome Pinmembertemp0x00714-Apr-09 6:28 
GeneralGreat Article PinmemberMachesis2-Mar-09 6:57 
GeneralNice one. PinmemberJijo raj19-Dec-08 23:54 
AnswerSDI with split window Pinmemberlookupstar12-Nov-08 20:26 
Questionwant to frezz split bar Pinmemberntimesc2-Mar-08 17:18 
AnswerRe: want to frezz split bar [modified] Pinmemberxtra200026-May-10 16:32 
GeneralLike your writing style Pinmembercount08-Jan-08 5:48 
Generalgood Pinmemberyanjing_24077-Dec-07 16:28 
GeneralVery Useful .... Pinmemberkokosan11-Jun-07 9:31 
GeneralLock Bar PinmemberHwewet8-May-07 3:07 
GeneralExcellent Tutorial! Pinmembereepcat5-Apr-07 3:36 
Generalvery useful Pinmembertz075-Jan-07 5:42 
GeneralThanks Pinmemberck wang1-Jan-07 16:43 
GeneralHidden Bug PinmemberAleksander Kravchuk18-Sep-06 9:18 
GeneralRe: Hidden Bug Pinmembermarcinj9-Mar-08 0:50 
GeneralNice Pinmemberwaldermort25-Aug-06 21:29 

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
Web02 | 2.8.140827.1 | Last Updated 1 Jan 2007
Article Copyright 2006 by kencocomputers
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid