SAMPLE: Xtenaccl.exe - Accelerators for File Manager Extensions

ID: Q100357

The information in this article applies to:

Microsoft Windows Software Development Kit (SDK) 3.1

SUMMARY

Xtenaccl.exe is a sample that installs a task-specific message hook (WH_GETMESSAGE) and calls TranslateAccelerator() on every WM_KEY and WM_KEYDOWN message. If an appropriate accelerator is found, TranslateAccelerator() passes a WM_COMMAND to the main window. File Manager extensions cannot directly use accelerators because extensions do not have their own message pump. File Manager pulls messages on behalf of the extensions, and does not load and translate extension's accelerators.

MORE INFORMATION

The following file is available for download from the Microsoft Download Center. Click the file name below to download the file:

Xtenaccl.exe

For more information about how to download files from the Microsoft Download Center, please visit the Download Center at the following Web address

http://www.microsoft.com/downloads/search.asp

and then click How to use the Microsoft Download Center.

The main window of File Manager handles and processes the WM_COMMAND message passed to it by TranslateAccelerator(). However, File Manager does not know how to handle that message because wParam (containing menu IDs) is defined by the extension. To interpret the correct value, File Manager dynamically changes an extension's menu IDs to suit its own needs. Therefore, XTENACCL traps the WM_COMMAND message passed by TranslateAccelerator() and routes it to a child window of its own. The child window in turn processes the menu command.

To intercept the WM_COMMAND message, XTENACCL is using a second message hook that is of type WH_CALLWNDPROC. Because TranslateAccelerator() sends a WM_COMMAND instead of posting it, this second hook was needed.

Additional query words: 0 file manager extension

Keywords : kbfile kbsample kb16bitonly kbFileManExt kbHook kbInput kbKeyAccel kbGrpUser kbWinOS310 kbGrpShell
Version : WINDOWS:3.1
Platform : WINDOWS
Issue type :