DOCUMENT:Q117500  11-FEB-2002  [visualc]
TITLE   :INFO: Using Accelerators with an MFC Modeless Dialog Box
PRODUCT :Microsoft C Compiler
PROD/VER::1.0,1.5,1.51,1.52,2.0,2.1,4.0
OPER/SYS:
KEYWORDS:kbDlg kbKeyAccel kbMFC KbUIDesign kbVC100 kbVC150 kbVC200 kbVC400 kbGrpDSMFCATL kbArchi

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - The Microsoft Foundation Classes (MFC), used with:
    - Microsoft Visual C++ for Windows, 16-bit edition, versions 1.0, 1.5, 1.51, 1.52 
    - Microsoft Visual C++, 32-bit Editions, versions 1.0, 2.0, 2.1, 4.0 
-------------------------------------------------------------------------------

SUMMARY
=======

To use accelerators with a modeless dialog box, override the
PreTranslateMessage()function in your derived CDialog class.

MORE INFORMATION
================

To use accelerators with your modeless dialog box, perform the following steps:

1. Create a modeless dialog box. For additional information, please see the
   following article in the Microsoft Knowledge Base:

   Q103788 Creating a Modeless Dialog Box with MFC Libraries

2. Insert this sample code into the files listed above the code:

      // .h file with your derived CDialog class.
      class CModeless : public CDialog
      {
         .
       public:
         virtual BOOL PreTranslateMessage(MSG*);
         .
      };

      //.cpp file.
      BOOL CModeless::PreTranslateMessage(MSG* pMsg)
      {
         HACCEL hAccel =
         ((CMainFrame*)AfxGetApp()->m_pMainWnd)->GetAccelTable();
         if(!(hAccel &&
              ::TranslateAccelerator(AfxGetApp()->m_pMainWnd->m_hWnd, hAccel,
                                     pMsg)))
              return CDialog::PreTranslateMessage(pMsg);
         else
            return TRUE;
      }

      // Mainfrm.h file, where CMainFrame is the main window class.
      HACCEL CMainFrame::GetAccelTable() { return m_hAccelTable; }

3. Create the accelerators with App Studio, or with Resource View from the
   Project Workspace in Visual C++ 32-bit Edition, version 4.0. The accelerators
   should be in the IDR_MAINFRAME accelerator table. They should also have the
   same ID as the controls or menu items with which they are associated.

Additional query words: kbinf 1.00 1.50 1.51 1.52 2.00 2.10 2.50 2.51 2.52 3.00 3.10 4.00

======================================================================
Keywords          : kbDlg kbKeyAccel kbMFC KbUIDesign kbVC100 kbVC150 kbVC200 kbVC400 kbGrpDSMFCATL kbArchitecture kbAcceleratorKey 
Technology        : kbAudDeveloper kbMFC
Version           : :1.0,1.5,1.51,1.52,2.0,2.1,4.0
Issue type        : kbinfo

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

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.

Copyright Microsoft Corporation 2002.