INFO: Calling MFC MDI Base Class Message Handlers

Last reviewed: October 10, 1997
Article ID: Q93916

The information in this article applies to:

  • The Microsoft Foundation Classes (MFC) included with:

        - Microsoft C/C++ version 7.0
        - Microsoft Visual C++ for Windows, versions 1.0, 1.5, 1.51, 1.52
        - Microsoft Visual C++ 32-bit Edition, versions 1.0, 2.0, 2.1, 2.2
          4.0
    

SUMMARY

In an application developed for the Microsoft Windows environment that uses the multiple document interface (MDI), an application that implements an MDI frame window or an MDI child window must pass certain messages to the default window procedure to provide default MDI functionality. When the application uses the Microsoft C++ Foundation Classes (MFC), the application calls the base class message handler after processing an MDI message to provide the default MDI behavior.

MORE INFORMATION

According to the Windows Software Development Kit (SDK) documentation for DefMDIChildProc, an application that uses MDI must pass messages to the appropriate function to provide default MDI behavior. In MFC, one of the message handling functions listed in the message map processes the MDI messages. If an application overrides the message handler for these messages, it may be necessary for the application to call the base class message handler after processing the message for MDI to function correctly.

The text below lists the messages processed by DefFrameProc() and DefMDIChildProc(), and the message handler that corresponds to each message:

Messages Processed by DefFrameProc()

   WM_COMMAND     OnCommand()
   WM_MENUCHAR    OnMenuChar()
   WM_SETFOCUS    OnSetFocus()
   WM_SIZE        OnSize()

Messages Processed by DefMDIChildProc()

   WM_CHILDACTIVATE    OnChildActivate()
   WM_GETMINMAXINFO    OnGetMinMaxInfo()
   WM_MENUCHAR         OnMenuChar()
   WM_MOVE             OnSize()
   WM_SETFOCUS         OnSetFocus()
   WM_SIZE             OnSize()
   WM_SYSCOMMAND       OnSysCommand()

If a class derived from CMDIFrameWnd overrides the OnCommand() message handler, it must call the CMDIFrameWnd::OnCommand() function for each message that it does not handle. Please refer to the Windows SDK documentation for more information about the messages processed by the DefFrameProc() and DefMDIChildProc() functions.
Keywords          : MfcUI kbfasttip kbinfo
Technology        : kbmfc
Version           : 1.0 1.5 1.51 1.52 2.0 2.1 2.2 4.
Platform          : MS-DOS NT WINDOWS


================================================================================


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: October 10, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.