CSplitterWnd Extension that Allows Switching Views in Any Pane

This article explains how to switch between multiple views in a splitter window pane without deleting and re-creating views. It is inefficient to create & destroy views, and often disrupts an application's design, yet the only examples of switching views I have found are doing just that! I have created a CSplitterWnd replacement class that adds the multiple views per pane functionality in a lightweight and easy to use way. NOTE: This class is intended for static splitters only, not dynamic ones.

I. How to use my code

I derived a class (AW_CMultiViewSplitter) from CSplitterWnd. You can simply include the files AW_CMultiViewSplitter.h and AW_CMultiViewSplitter.cpp to your project, use a AW_CMultiViewSplitter instead of a classic splitter window and call the 2 following functions:

int AddView(int nRow, int nCol, CRuntimeClass * pViewClass, CCreateContext* pContext)
This function should be called where you would usually call CreateView() but you want more than one view for the pane. If you only need a single view, just call CreateView(), as usual. AddView() returns an int, which is the ID of the newly created view. This ID is used in the function ShowView() if you want to make this new view visible.

void ShowView(int viewID)
This function takes a viewID as its only parameter. This function takes care of hiding the previously visible view and showing the requested one.

II. Points of interest

I will skip the detailed code here and just explain the basic idea that makes it work. For the details, you can download the little sample I wrote to illustrate the use of my splitter window.

The 2 point of interest are:
- how to create multiple views in a same pane
- how to switch between views

How to create multiple views in a same pane

In a classic splitter window, when a view is created in a pane, its window identifier is set to an ID computed from the row and column numbers corresponding to the pane. Therefore, when you have multiple views for a pane, you must set all but one to ID zero as well as hide all the non-visible views.

The following code block demonstrates how to add a new view to a pane when one is currently assigned to the pane:

HideCurrentView(nRow, nCol)
{
 CWnd * pView  = GetCurrentView(pane.row, pane.col);
 pView->SetDlgCtrlID(0);
 pView->ShowWindow(SW_HIDE);
}

CreateView(nRow, nCol, pViewClass, CSize(10,10), pContext);

SetCurrentView(nRow, nCol, newViewID)
{
 CWnd * pView  = GetView( viewID);
 pView->SetDlgCtrlID(IdFromRowCol(pane.row, pane.col));
 pView->ShowWindow(SW_SHOW);
}

How to switch between windows

The window that is displayed is the one whose identifier is the ID computed from the row and column numbers. Then, to switch views, you just need to get the visible one, set its ID to something else, hide it, get the window you want to see, set its ID to the good one (obtained by calling IdFromRowCol), show it, and refresh the splitter.

GetPaneFromViewID(viewID);
HideCurrentView(pane.row, pane.col);
SetCurrentView(pane.row, pane.col, viewID);

Downloads

Download demo project - 29 Kb
Download source - 3 Kb


Comments

  • There are no comments yet. Be the first to comment!

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Companies undertaking an IT project need to find the right balance between cost and functionality. It's important to start by determining whether to build a solution from scratch, buy an out-of-the-box solution, or a combination of both. In reality, most projects will require some system tailoring to meet business requirements. Decision-makers must understand how much software development is enough and craft a detailed implementation plan to ensure the project's success. This white paper examines the different …

  • The mobile market is white hot. Building a well-crafted product development plan that addresses market research, strategy, design, and development will provide the greatest chance for success. Each phase of an app's lifecycle is critical to the its overall success and feeds into the next step of the process of product development for the app. This white paper examines the five key phases of mobile app creation, one by one, to understand how they work together to help create a successful mobile app.

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date