Microsoft KB Archive/104460

= PRB: Menu Mnemonics Not Working During In-Place Activation =

Article ID: 104460

Article Last Modified on 3/3/2005

-

APPLIES TO

 Microsoft OLE 2.0 Microsoft OLE 4.0, when used with:  Microsoft Windows NT 4.0

 Microsoft Windows NT 3.51 Service Pack 5

 Microsoft Windows NT 4.0

 Microsoft Windows 95</li></ul>

 Microsoft Windows 2000 Standard Edition</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q104460

<div class="symptoms_section">

SYMPTOMS
The menu mnemonics for an object do not operate properly, causing the system to hang.

<div class="cause_section">

CAUSE
The server application is not calling OleTranslateAccelerator inside of its message loop.

<div class="resolution_section">

RESOLUTION
For menu commands to be dispatched properly during in-place editing, OLE 2.0 needs to have the server application call OleTranslateAccelerator, even if the server application does not have accelerator support. This OLE application programming interface (API) does the needed translation of key messages, and ensures that the appropriate action occurs.

To be more efficient, a server application need only pass "keystroke" messages to OleTranslateAccelerator. The following code demonstrates what the message loop for an OLE server application should look like:

Sample Code
// Message loop for an OLE server. // while (GetMessage(&msg, NULL, NULL)) {   if (m_fInplaceActive)  // If currently active in place. if (msg.message >= WM_KEYFIRST && msg.message <= WM_KEYLAST) // If it is a "keystroke" message. if (OleTranslateAccelerator(...) == NOERROR) continue; // OLE handled the message

TranslateMessage(...); DispatchMessage(...); }

<div class="moreinformation_section">

MORE INFORMATION
When the object's server is a stand-alone .EXE and the in-place active object gets a keystroke message that is not a recognized accelerator, the object must check to see if the message is one that the container recognizes by calling the OleTranslateAccelerator function. If the container does not want the keystroke, then the OleTranslateAccelerator function will return FALSE. In this case, the object should continue using its normal TranslateMessage and DispatchMessage code.

If the container accepts the keystroke, OLE will call the container's IOleInPlaceFrame::TranslateAccelerator member function to translate the message. The container may call the Windows TranslateAccelerator and/or TranslateMDISysAccel functions to process the accelerator key, or do its own special processing.

Additional query words: 2.00 3.50 4.00

Keywords: kbprogramming kbprb KB104460

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.