Click here to Skip to main content
Click here to Skip to main content
Go to top

Modal MFC frame window

, 9 Aug 2005
Rate this:
Please Sign up or sign in to vote.
Utility class that helps to implement a modal dialog's behavior for any CFrameWnd-derived window class in an easy way.

Introduction

Sometimes, it may be useful to have a modal window with Doc/View architecture, toolbars/statusbar support (i.e. base features implemented in MFC frame windows). How to get these without implementing all of these features in a CDialog-derived class? The CModalFrame utility class presented here helps you implement a modal dialog's behavior for any CFrameWnd-derived window class in an easy way.

If you have to use it and have a bit of time, please add a comment at the bottom of this page and tell, in which context you decided to use this code. I would be interested.

Background

Some basic facts:

  • All required features are already implemented in CFrameWnd-derived classes.
  • The basic support of modal message loop is already implemented in the CWnd class.

Brief implementation description:

  1. The utility code uses only the CFrameWnd class interface and does not make any suggestions about the internal implementation details of any CFrameWnd-derived classes.
  2. CModalFrame::Run creates an instance of the internal CModalDialogLock class which:
    • stores modal loop context,
    • runs modal message loop and,
    • supports multiple running modal frames.
  3. CModalDialogLock subclasses the created frame window to provide:
    • update command UI for the frame on WM_KICKIDLE message,
    • exit from modal message loop on WM_NCDESTROY message and,
    • restore standard modal window behavior on WM_NCACTIVATE message.
  4. You should not use WS_CHILD window style for a frame. Because its parent window is disabled during modal loop. So child frame window also will be disabled (for example, MDI child frame)!

Using the code

  • Files needed:
    • ModalFrame.h
    • ModalFrame.cpp

Sample of usage:

void CMyView::OnRunModalFrame()
{
    CCreateContext context;
    context.m_pNewViewClass = RUNTIME_CLASS(CMyOtherView);
    context.m_pCurrentDoc = GetDocument();
    context.m_pNewDocTemplate = GetDocument()->GetTemplate();
    context.m_pLastView = this;
    context.m_pCurrentFrame = GetParentFrame();

    CRuntimeClass * pFrameClass = RUNTIME_CLASS(CMyModalFrame);

    if (!CModalFrame::Run(*pFrameClass, false, IDR_MYFRAMERESOURCE,
                          WS_OVERLAPPEDWINDOW | 
                          FWS_ADDTOTITLE, this, &context))
    {
        AfxMessageBox(AFX_IDP_COMMAND_FAILURE);
    }
}

// don't forget close modal frame like a modal dialog box!
void CMyModalFrame::OnClose()
{
    int nModalResult = -1;
    CModalFrame::End(this, nModalResult);
}

See demo project code for more details.

History

  • Version 1.2
    • Bug fixing.
    • More accurate work with a stack of modal frames.
  • Version 1.1
    • Implemented support for multiple running modal frames.
    • More accurate restoring active window after the end of the modal message loop.
  • Version 1.0
    • Initial version.

License

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

Share

About the Author

Alexey Nikitin
Team Leader Complex A5 Co. Ltd.
Russian Federation Russian Federation
No Biography provided

Comments and Discussions

 
QuestionProblem through repeated loading of resource statuses from the registry. PinmemberSNMP.H10-Jul-14 23:12 
QuestionIs it possible to pass parameters to my frame constructor? PinmemberSNMP.H8-May-14 5:07 
AnswerRe: Is it possible to pass parameters to my frame constructor? PinmemberAlexey Nikitin8-May-14 9:53 
QuestionInsert controls to dialog [modified] PinmemberSNMP.H29-Apr-14 20:15 
AnswerRe: Insert controls to dialog PinmemberAlexey Nikitin8-May-14 10:54 
QuestionCan it be possible to take a CMFCToolbar instead of CToolbar? PinmemberMember 88337239-Apr-14 20:41 
AnswerRe: Can it be possible to take a CMFCToolbar instead of CToolbar? PinmemberAlexey Nikitin13-Apr-14 19:10 
GeneralHow to use this class on WINCE project? PinmemberNewttleLi2-Apr-13 23:16 
GeneralThank you Pinmember_Jason23-May-12 16:10 
GeneralThank you for your simple project PinmemberLi Shu23-Oct-08 19:50 
GeneralIs it possible to pass parameters to my view or frame after doModal and how! Pinmemberchiheb zak27-Feb-07 11:10 
AnswerRe: Is it possible to pass parameters to my view or frame after doModal and how! PinmemberAlexey Nikitin12-Mar-07 7:52 
GeneralRe: Is it possible to pass parameters to my view or frame after doModal and how! Pinmemberchiheb zak13-Mar-07 3:36 
GeneralWorks well but crashes when opening folder on desktop PinmemberWolfram Rösler31-Jan-07 3:22 
GeneralRe: Works well but crashes when opening folder on desktop PinmemberAlexey Nikitin15-Feb-07 12:00 
GeneralRe: Works well but crashes when opening folder on desktop PinmemberWolfram Rösler19-Feb-07 22:19 
GeneralVery useful and practical code Pinmemberskywalkerking28-Nov-06 7:57 
Generalaccess violation error with modal in modal PinmemberBrad Ulrich17-May-05 8:07 
GeneralRe: access violation error with modal in modal PinmemberAlexey Nikitin21-May-05 23:32 
GeneralRe: access violation error with modal in modal PinmemberBrad Ulrich2-Aug-05 4:19 
GeneralRe: access violation error with modal in modal PinsussAnonymous11-Aug-05 10:12 
GeneralRe: access violation error with modal in modal PinmemberAlexey Nikitin11-Aug-05 10:15 
QuestionHow to embody Modeless Frame Window ? PinmemberUriDokDo31-Mar-05 2:20 
GeneralModal CMDIFrameWnd PinmemberUrban Olars17-Dec-04 11:17 
GeneralRe: Modal CMDIFrameWnd Pinmemberdirtcooker25-May-05 2:48 

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.140926.1 | Last Updated 9 Aug 2005
Article Copyright 2003 by Alexey Nikitin
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid