DOCUMENT:Q183167  27-MAR-2002  [visualc]
TITLE   :PRB: TranslateAccelerator() Not Called for ActiveX Controls
PRODUCT :Microsoft C Compiler
PROD/VER::4.0,4.1,4.2,5.0,6.0
OPER/SYS:
KEYWORDS:kbole kbMFC kbVC400 kbVC410 kbVC420 kbVC500 kbVC600

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

 - The Microsoft Foundation Classes (MFC), used with:
    - Microsoft Visual C++, 32-bit Editions, versions 4.0, 4.1 
    - Microsoft Visual C++, 32-bit Enterprise Edition, versions 4.2, 5.0, 6.0 
    - Microsoft Visual C++, 32-bit Professional Edition, versions 4.2, 5.0, 6.0 
    - Microsoft Visual C++, 32-bit Learning Edition, version 6.0 
    - Microsoft Visual C++.NET (2002) 
-------------------------------------------------------------------------------

SYMPTOMS
========

An ActiveX control can process keyboard messages in the
IOleInPlaceActiveObject::TranslateAccelerator() function. If the ActiveX control
is created dynamically in a CView class or a CPropertyPage class,
TranslateAccelerator() will not be called.

CAUSE
=====

The CView and CPropertyPage classes are not designed to host ActiveX controls,
therefore they do not call the TranslateAccelerator() function.

RESOLUTION
==========

Override the PreTranslateMessage() function and call the PreTranslateInput()
function. This results in a call to the COccManager::IsDialogMessage() function,
which calls the control's IOleInPlaceActiveObject::TranslateAccelerator()
function.

The following sample code shows how to override PreTranslateMessage() in a
CView-derived class called CTestView:

Sample Code
-----------

      BOOL CTestView::PreTranslateMessage(MSG* pMsg)
      {
         CView::PreTranslateMessage(pMsg);
         return PreTranslateInput (pMsg);
      }

STATUS
======

This behavior is by design.

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

Steps to Reproduce Behavior
---------------------------

1. Create an ActiveX control project with the MFC ActiveX ControlWizard.

2. In the WM_CREATE message handler, create two edit controls as child windows
   of the ActiveX control, as in the following example:

         // CEditOCXCtrl is a COleControl-derived class.
         int CEditOCXCtrl::OnCreate(LPCREATESTRUCT lpCreateStruct)
         {
            if (COleControl::OnCreate(lpCreateStruct) == -1)
               return -1;

            // m_Edit1 and m_Edit2 are of type CEdit.
            VERIFY(m_Edit1.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP |
                                  WS_BORDER,
               CRect(10, 10, 100, 40), this, 100));
            VERIFY(m_Edit2.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP |
                                  WS_BORDER,
               CRect(10, 50, 100, 80), this, 101));
            return 0;
         }

3. Override PreTranslateMessage() in the COleControl-derived class as follows:

         BOOL CEditOCXCtrl::PreTranslateMessage(MSG* pMsg)
         {
            if (pMsg->message >= WM_KEYFIRST && pMsg->message <= WM_KEYLAST)
            {
               // Allow tabbing between child controls.
               if (VK_TAB == pMsg->wParam)
               {
                  if (IsDialogMessage(pMsg))
                     return TRUE;
               }
            }

            return COleControl::PreTranslateMessage(pMsg);
         }

4. Create an SDI application with CView as its view class in AppWizard.

5. Insert the ActiveX control's CWnd-wrapper class to the SDI project in
   Component Gallery.

   NOTE: To insert the ActiveX control's wrapper class using the .NET IDE,
   right-click on the project and select Add | Add Class from the Context menu.
   In the Add Class dialog box, select the "MFC Class from ActiveX Control"
   template, and then select Open. In the Add Class from ActiveX control Wizard
   select your control from the drop down list, add the interfaces and select
   Finish.

6. Create the ActiveX control dynamically in the OnInitialUpdate() function of
   the CView-derived class:

         // CSdiView is a CView-derived class.
         void CSdiView::OnInitialUpdate()
         {
            CView::OnInitialUpdate();

            m_pSelection = NULL;    // Initialize selection.

            // m_EditOCX is the CWnd-wrapper class of the ActiveX control.
            VERIFY(m_EditOCX.Create("", WS_CHILD | WS_VISIBLE | WS_TABSTOP,
               CRect(10, 10, 200, 200), this, 555));
         }

7. Build the SDI project and run the SDI application. Type something in the edit
   control of the ActiveX control. Note that the PreTranslateMessage() of the
   ActiveX control is not called.

Additional query words: ocx

======================================================================
Keywords          : kbole kbMFC kbVC400 kbVC410 kbVC420 kbVC500 kbVC600 
Technology        : kbAudDeveloper kbMFC kbVCNET
Version           : :4.0,4.1,4.2,5.0,6.0
Issue type        : kbprb

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

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.