Click here to Skip to main content
12,746,945 members (28,794 online)
Click here to Skip to main content
Add your own
alternative version


64 bookmarked
Posted 15 May 2002

Toolbar in splitter window pane

, 15 May 2002
Rate this:
Please Sign up or sign in to vote.
How to add a docking toolbar to a splitter window pane
<!-- Download Links --> <!-- Article image -->

Sample Image - image002.jpg

<!-- Add the rest of your HTML here -->


This brief article describes a simple way to add a toolbar inside one or more panes of a splitter window. Typically when you create a splitter window in the OnCreateClient method of your CMainFrame class, you supply CView derived classes to the CSplitterWnd::CreateView method. However, the class supplied does not need to be a CView derived class. It can be any CWnd derived class. If you look inside the MFC code for the CSplitterWnd class you will see that the class uses CWnd pointers not CView pointers. Methods in the CSplitterWnd class that deal with windows, use CWnd pointers. For instance, CSplitterWnd::GetPane returns a CWnd. This allows us to use a CFrameWnd derived class instead of a CView derived class. Since the CFrameWnd class provides all the toolbar / docking support, we can easily add a toolbar to each splitter pane that is derived from CFrameWnd. Below is the OnCreateClient code from my sample application:

<PRE lang=c++>BOOL CMainFrame::OnCreateClient(LPCREATESTRUCT lpcs, CCreateContext* pContext) { m_wndSplit.CreateStatic(this, 1, 2); m_wndSplit.CreateView(0,0,pContext->m_pNewViewClass, CSize(175, 500), pContext); // Create the view using a CFrameWnd derived class. m_wndSplit.CreateView(0,1,RUNTIME_CLASS(CSplitFrame), CSize(175, 500), pContext); // Activate view pane. SetActiveView((CView *) m_wndSplit.GetPane(0,0)); RecalcLayout(); return TRUE; // return CFrameWnd::OnCreateClient(lpcs, pContext); }

Now, your CFrameWnd derived class must do two things. First it has to create your view class in the OnCreateClient method. My sample code uses a CFormView derived class:

BOOL CSplitFrame::OnCreateClient(LPCREATESTRUCT lpcs, 
                                  CCreateContext* pContext) 
    CSplitView *pview;

    // Create a context.
    CCreateContext context;
    pContext = &context;

    // Assign custom view.
    pContext->m_pNewViewClass = RUNTIME_CLASS(CSplitView);

    // Create the view.
    pview = (CSplitView *) CreateView(pContext, AFX_IDW_PANE_FIRST);
    if (pview == NULL)
        return FALSE;

    // Notify the view.
    SetActiveView(pview, FALSE);

    return TRUE;

The second thing your CFrameWnd derived class must do is create the toolbar that will appear in the splitter pane:

int CSplitFrame::OnCreate(LPCREATESTRUCT lpCreateStruct) 
    if (CFrameWnd::OnCreate(lpCreateStruct) == -1)
        return -1;
    if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, 
                              WS_CHILD | WS_VISIBLE | CBRS_TOP
        TRACE0("Failed to create toolbar\n");
        return -1;      // fail to create

    m_wndToolBar.SetBorders(3, 3, 3, 3);
    return 0;

That's it! Now you have a fully dockable toolbar for your splitter window pane. Easy!


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Tom Shope
Web Developer
United States United States
Graduate of University of Texas with B.S. in Computer Engineering. 14 years software development experience. Currently a software developer for Storcomm Inc. a medical imaging solutions provider in Jacksonville Florida.

You may also be interested in...

Comments and Discussions

GeneralCommercial use of code Pin 21:01 21:01 
GeneralRemove lines to link to document Pin
fannyc4-Aug-06 7:08
memberfannyc4-Aug-06 7:08 
QuestionHow the two cview communicate? Pin
AwinHuang14-Apr-06 1:05
memberAwinHuang14-Apr-06 1:05 
AnswerRe: How the two cview communicate? Pin
jhwurmbach18-Aug-06 0:41
memberjhwurmbach18-Aug-06 0:41 
GeneralDocument won't save on Close Pin
Phil Fortier23-Sep-05 20:54
memberPhil Fortier23-Sep-05 20:54 
GeneralA handle to the MENU of a drop down button Pin
Alex Evans16-Nov-04 14:28
memberAlex Evans16-Nov-04 14:28 
GeneralNo correct message maps :( Pin
Damos10-Oct-03 2:16
memberDamos10-Oct-03 2:16 
GeneralSmall omission in your article Pin
Babak Asadi17-Sep-03 10:04
memberBabak Asadi17-Sep-03 10:04 
GeneralCFrameWnd resize problem Pin
Chris Losinger23-May-03 10:29
memberChris Losinger23-May-03 10:29 
GeneralFixed Pin
Chris Losinger23-May-03 11:14
memberChris Losinger23-May-03 11:14 
GeneralRe: Access Document from View Pin
Roberto Rocco10-Mar-03 11:00
memberRoberto Rocco10-Mar-03 11:00 
GeneralRe: Access Document from View Pin
dongdks23-Jul-03 23:43
memberdongdks23-Jul-03 23:43 
GeneralToolBarControls Pin
AnthonyWinters30-Oct-02 10:30
memberAnthonyWinters30-Oct-02 10:30 
GeneralRe: ToolBarControls Pin
Ridgeley Yu12-May-03 1:18
memberRidgeley Yu12-May-03 1:18 
GeneralRe: ToolBarControls Pin
Tobias Svensson13-Oct-03 1:16
memberTobias Svensson13-Oct-03 1:16 
GeneralNo document pointer Pin
Edmund Vermeulen29-Sep-02 23:47
sussEdmund Vermeulen29-Sep-02 23:47 
GeneralFrame Window Pin
Timbit27-Aug-02 14:39
memberTimbit27-Aug-02 14:39 
GeneralRe: Frame Window Pin
Timbit27-Aug-02 19:28
memberTimbit27-Aug-02 19:28 
GeneralRe: Frame Window Pin
Warren Gardner25-Nov-02 15:35
memberWarren Gardner25-Nov-02 15:35 
GeneralRe: Frame Window - Possibly even easier Pin
John Famiglietti29-Nov-02 9:24
memberJohn Famiglietti29-Nov-02 9:24 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170215.1 | Last Updated 16 May 2002
Article Copyright 2002 by Tom Shope
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid