Click here to Skip to main content
12,457,938 members (50,677 online)
Click here to Skip to main content
Add your own
alternative version

Stats

163.2K views
72 bookmarked
Posted

Switching to other views in a doc-view application

, 28 Dec 1999
Rate this:
Please Sign up or sign in to vote.
Switching to other views in a doc-view application.

Introduction

In a previous article, we discussed how to replace views in a document-view application. The views to replace were destroyed, and new views were created to replace them. Sometimes it's better to preserve the views and use them later rather than to destroy and recreate them. In this article, we show how to switch to other views without destroying the old ones, so we could use them later.

In the code below, the inactive views are disconnected from the document (so they don't receive OnUpdate messages) using CDocument::RemoveView. When needed, they are reconnected to the document and resynchronized using CDocument::AddView. In order to keep the inactive views synchronized with the document, we should have to implement custom hints (using the pHint parameter in the CView::OnUpdate member function). The views are hidden and shown using the CWnd::ShowWindow member function.

The Code

The code needed to implement view switching depends on the frame window containing the view. There are three common cases: the view is contained within a CFrameWnd (SDI application), the view is contained within a CMDIChildWnd (MDI application) and the view is a pane of a splitter window, either in SDI or MDI applications. In all cases, what we need is a method in our document class to switch to the desired view. This method should receive the new view as a parameter and return the view that was replaced. This returned view is not contained in the document's list anymore. The advantage of having this method in the document class becomes obvious when there are several document types each of which can have different view types. Let's start with an SDI application that doesn't have splitters:

CView* CMyDocument::SwitchToView ( CView* pNewView )
{
   CFrameWnd* pMainWnd = (CFrameWnd*)AfxGetMainWnd();
   CView* pOldActiveView = pMainWnd->GetActiveView();
   ASSERT(pOldActiveView != NULL);
   ASSERT_VALID(pOldActiveView);
   ASSERT(pOldActiveView->GetDocument() == this); // must be attached to us

   /* Set the child window ID of the active view to AFX_IDW_PANE_FIRST.
      This is necessary so that CFrameWnd::RecalcLayout will allocate
      this "first pane" to that portion of the frame window's client
      area not allocated to control bars.  Set the child ID of
      the previously active view to some other ID.
   */

   ::SetWindowLong(pOldActiveView->m_hWnd, GWL_ID, 0);
   ::SetWindowLong(pNewView->m_hWnd, GWL_ID, AFX_IDW_PANE_FIRST);

   // Show the newly active view and hide the inactive view.
   pNewView->ShowWindow(SW_SHOW);
   pOldActiveView->ShowWindow(SW_HIDE);

   // Connect the newly active view to the document,
   // and disconnect the inactive view
   AddView(pNewView); 
   RemoveView(pOldActiveView);
   pMainWnd->SetActiveView(pNewView);
   pMainWnd->RecalcLayout();

   return pOldActiveView;
}

In the case of an MDI application (again without splitters):

CView* CMyDocument::SwitchToView ( CView* pNewView )
{
   CMDIFrameWnd* pMainWnd = (CMDIFrameWnd*)AfxGetMainWnd();

   // Get the active MDI child window.
   CMDIChildWnd* pChild = (CMDIChildWnd*)pMainWnd->MDIGetActive();

   // Get the active view attached to the active MDI child window.
   CView* pOldActiveView = pChild->GetActiveView();

   // Set flag so that document will not be deleted when view is dettached.
   BOOL bAutoDelete = m_bAutoDelete;
   m_bAutoDelete = FALSE;

   // Dettach existing view
   RemoveView(pOldActiveView);

   // restore flag
   m_bAutoDelete = bAutoDelete;

   // Show the newly active view and hide the inactive view.
   pNewView->ShowWindow(SW_SHOW);
   pOldActiveView->ShowWindow(SW_HIDE);

   // Attach new view
   AddView(pNewView);

   pChild->RecalcLayout();
   pNewView->UpdateWindow();
   pChild->SetActiveView(pNewView);
   return pOldActiveView;
}

When the view to replace is a pane of a splitter window, there is also a small difference between SDI and MDI applications, related to the retrieval of the current active view. In the method below, you must comment out what you don't need depending on your application type:

CView* CSDISplitDoc::SwitchToView ( CView* pNewView )
{
/* Uncomment this if this is a SDI application
   CFrameWnd* pMainWnd   = (CFrameWnd*)AfxGetMainWnd();
   CView* pOldActiveView = pMainWnd->GetActiveView();
*/

/* Uncomment this if this is a MDI application
   CMDIFrameWnd* pMainWnd = (CMDIFrameWnd*)AfxGetMainWnd();

   // Get the active MDI child window.
   CMDIChildWnd* pChild = (CMDIChildWnd*)pMainWnd->MDIGetActive();

   // Get the active view attached to the active MDI child window.
   CView* pOldActiveView = pChild->GetActiveView();
*/

   CSplitterWnd* pSplitter = (CSplitterWnd *)pOldActiveView->GetParent();
   int row, col;
   ASSERT(pSplitter->IsChildPane(pOldActiveView, row, col));

   // set flag so that document will not be deleted when view is destroyed
   m_bAutoDelete = FALSE;    

   // Dettach existing view
   RemoveView(pOldActiveView);

   // set flag back to default 
   m_bAutoDelete = TRUE;
 
   /* Set the child window ID of the active view to the ID of the corresponding
      pane. Set the child ID of the previously active view to some other ID.
   */
   ::SetWindowLong(pOldActiveView->m_hWnd, GWL_ID, 0);
   ::SetWindowLong(pNewView->m_hWnd, GWL_ID, pSplitter->IdFromRowCol(row, col));

   // Show the newly active view and hide the inactive view.
   pNewView->ShowWindow(SW_SHOW);
   pOldActiveView->ShowWindow(SW_HIDE);

   // Attach new view
   AddView(pNewView);

   // Set active 
   pSplitter->GetParentFrame()->SetActiveView(pNewView);
   
   pSplitter->RecalcLayout(); 
   pNewView->SendMessage(WM_PAINT); 

   return pOldActiveView;
}

The SwitchToView functions above receive a pointer to an existing view, so a view must have already been created without attaching it to a document. Note that this imposes restrictions on view creation code, which should not make use of the document in any way (for example, the OnInitialUpdate member function). Otherwise, exceptions might occur. The newly activated view is shown before it is attached to the document, so functions in the view that respond to Windows messages such as WM_SIZE or WM_GETMINMAXINFO should not make use of the document either.

The view must be created with correct parent window and window ID. Both parameters depend on the frame windows containing the view, just the same as the SwithToView function. The non-active views could be created the first time the menu to select one of them was selected or somewhere in the document initialization code. Supposing we have a m_pView1 member in the document class that is a pointer to a view, this is how it should be created in a SDI application:

if (!m_pView1)
{
   // create the new view
   m_pView1 = new CView1;
   m_pView1->Create(NULL, NULL, AFX_WS_DEFAULT_VIEW, CFrameWnd::rectDefault, 
   AfxGetMainWnd(), AFX_IDW_PANE_FIRST+1, NULL);
}

In a MDI application:

   CMDIFrameWnd* pMainWnd = (CMDIFrameWnd*)AfxGetMainWnd();
   // Get the active MDI child window.
   CMDIChildWnd* pChild = (CMDIChildWnd*)pMainWnd->MDIGetActive();

   if (!m_pView1)
   {
   // create the new view
   m_pView1 = new CView1;
   m_pView1->Create(NULL, NULL, AFX_WS_DEFAULT_VIEW, CRect(0, 0, 0, 0), 
                   pChild, AFX_IDW_PANE_FIRST, NULL);
}

And finally, if the view is a pane of a splitter window (read the comments to difference between SDI and MDI applications):

/* Uncomment this if this is a SDI application
   CFrameWnd* pMainWnd = (CFrameWnd*)AfxGetMainWnd();
   CView* pActiveView = pMainWnd->GetActiveView();
   CSplitterWnd* pSplitter = (CSplitterWnd *)pActiveView->GetParent();
*/

/* Uncomment this if this is a MDI application
   CMDIFrameWnd* pMainWnd = (CMDIFrameWnd*)AfxGetMainWnd();
   CMDIChildWnd* pChild = (CMDIChildWnd*)pMainWnd->MDIGetActive();
   CView* pActiveView = pChild->GetActiveView();
   CSplitterWnd* pSplitter = (CSplitterWnd *)pActiveView->GetParent();
*/

   if (!m_pView1)
   {
      // create the new view
      m_pView1 = new CView1;
      m_pView1->Create(NULL, NULL, AFX_WS_DEFAULT_VIEW, 
               CRect(0, 0, 0, 0),  pSplitter, 0, NULL);
   }

When we already have an existing view (m_pView1 in our example), we can make this view active as follows:

CView* pOldActiveView = SwitchToView(m_pView1);
if (!pOldActiveView)
   // there was not an active view
else
   // pOldActiveView is a pointer to the now inactive view

Note that inactive views destroy themselves when their parent window is destroyed, so you don't have to worry about destroying them.

License

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

Share

About the Author

No Biography provided

You may also be interested in...

Pro
Pro

Comments and Discussions

 
GeneralMy vote of 5 Pin
Mihai MOGA24-Oct-11 1:11
memberMihai MOGA24-Oct-11 1:11 
QuestionA Sample App Pin
Maddison Joyce17-Feb-09 0:35
memberMaddison Joyce17-Feb-09 0:35 
GeneralDialog inside CView Pin
guyjasper7-Nov-07 6:09
memberguyjasper7-Nov-07 6:09 
GeneralRe: Dialog inside CView Pin
sharon3-Apr-08 19:52
member sharon3-Apr-08 19:52 
GeneralRe: Dialog inside CView Pin
Nigel Quinnin28-Aug-08 8:25
memberNigel Quinnin28-Aug-08 8:25 
Questionexample project? Pin
forhug3-Apr-06 22:06
memberforhug3-Apr-06 22:06 
Generalvc++ help Pin
Anonymous30-Dec-04 18:47
sussAnonymous30-Dec-04 18:47 
GeneralSwitchView , big problem Pin
pank00710-Dec-04 13:17
memberpank00710-Dec-04 13:17 
GeneralCreating and switching views: a possible solution (updated) Pin
T.T.H.28-Oct-04 4:54
memberT.T.H.28-Oct-04 4:54 
GeneralNew Document Pin
bfadi19-Sep-03 1:30
memberbfadi19-Sep-03 1:30 
GeneralSwitching to other view with CRecordView class Pin
Rod Enns27-Jun-03 10:43
memberRod Enns27-Jun-03 10:43 
GeneralSplitter in one of the switching views Pin
Anonymous9-Apr-03 19:41
sussAnonymous9-Apr-03 19:41 
GeneralProblem creating view Pin
VanHlebar29-Nov-02 9:35
memberVanHlebar29-Nov-02 9:35 
GeneralRe: Problem creating view Pin
Rolando E. Cruz-Marshall1-Dec-02 16:20
memberRolando E. Cruz-Marshall1-Dec-02 16:20 
GeneralRe: Problem creating view Pin
T.T.H.5-Apr-05 23:56
memberT.T.H.5-Apr-05 23:56 
QuestionMore than one View at one time ? Pin
akraus2-Oct-01 1:14
memberakraus2-Oct-01 1:14 
Questionbarcode ?? Pin
Kimo10-Aug-00 17:03
sussKimo10-Aug-00 17:03 
AnswerRe: barcode ?? Pin
Ernesto11-Jan-01 11:18
memberErnesto11-Jan-01 11:18 
GeneralRe: barcode ?? Pin
Jose Cruz9-Jul-01 13:42
memberJose Cruz9-Jul-01 13:42 
GeneralChanging Documents Pin
Franz Klein9-Jul-00 1:24
sussFranz Klein9-Jul-00 1:24 
Questionwindows 2000? Pin
Jeff Ellis26-Jun-00 17:30
sussJeff Ellis26-Jun-00 17:30 
AnswerRe: windows 2000? Pin
Anonymous28-Feb-01 23:50
memberAnonymous28-Feb-01 23:50 
GeneralThis is a very useful sample Pin
Jeff23-May-00 17:33
sussJeff23-May-00 17:33 
Generalpassing CView* to document class Pin
Alicia4-Apr-00 19:04
sussAlicia4-Apr-00 19:04 
GeneralRe: passing CView* to document class Pin
Jose26-Jul-00 2:34
sussJose26-Jul-00 2:34 

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.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.160826.1 | Last Updated 29 Dec 1999
Article Copyright 1999 by Jorge Lodos
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid