IOleInPlaceActiveObject::TranslateAccelerator
Processes
menu accelerator-key messages from the container s message queue. This method
should only be used for objects created by a DLL object application.
HRESULT TranslateAccelerator(
|
LPMSG lpmsg |
//Pointer to message that may need translating |
|
); |
|
Parameter
lpmsg
[in] Pointer
to the message that might need to be translated.
Return Values
This method
supports the standard return values E_INVALIDARG, E_OUTOFMEMORY, and
E_UNEXPECTED, as well as the following:
S_OK
The message
was translated successfully.
S_FALSE
The message
was not translated.
Remarks
Notes to Callers
Active
in-place objects must always be given the first chance at translating
accelerator keystrokes. You can provide this opportunity by calling IOleInPlaceActiveObject::TranslateAccelerator
from your container s message loop before doing any other translation. You
should apply your own translation only when this method returns S_FALSE.
If you call IOleInPlaceActiveObject::TranslateAccelerator
for an object that is not created by a DLL object application, the default
object handler returns S_FALSE.
Notes to Implementers
An object
created by an EXE object application gets keystrokes from its own message pump,
so the container does not get those messages.
If you need
to implement this method, you can do so by simply wrapping the call to the
Window s TranslateAccelerator function.
See Also
TranslateAccelerator in Win32