IShellView::TranslateAccelerator

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

Processes menu accelerator-key messages from the container's message queue.

HRESULT TranslateAccelerator(

LPMSG lpmsg	// Points to a message that may need translating.
);

Parameters
lpmsg
Pointer to the message that might need to be translated.

Return Values
Returns NOERROR if successful or an OLE-defined error value otherwise.

Returning S_OK indicates that the message was translated and should not be translated or dispatched by the Explorer.

Remarks
TranslateAccelerator is called by the Explorer to let the view translate its accelerators.

Notes to Callers
The Explorer calls this method before any other translation if the view has the focus. If the view does not have the focus (if the tree has it, for example) this is called after the Explorer translates its own accelerators.

Notes to Implementors
By default, the view should return S_FALSE so that the Explorer can either do it's own accelerator translation or normal menu dispatching. The view should return S_OK only if it has processed the message as the accelerator and does not want the Explorer to process it further.