函数功能:翻译
加速键表。该函数处理菜单命令中的
加速键。该函数将一个WM_KEYDOWN或WM_SYSKEYDOWN消息翻译成一个WM_COMMAND或WM_SYSCOMMAND消息(如果在给定的
加速键表中有该键的入口),然后将WM_COMMAND或WM_SYSCOMMAND消息直接送到相应的窗口处理过程。
TranslateAccelerator直到窗口过程处理完消息后才返回。
函数原型:int TranslateAccelerator(HWND hWnd,HACCEL hAccTable,LPMSG IpMsg);
参数
:
hWnd:
窗口句柄,该窗口的消息将被翻译。
备注
:为了将该函数发送的消息与菜单或控制发送的消息区别开来,使WM_COMMAND或WM_SYSCOMMAND消息的wParam参数的高位字值为1。用于从
窗口菜单中选择菜单项的
加速键组合被翻译成WM_SYSCOMMAND消息:所有其他的加速键组合被翻译成WM_COMMAND。若TransLateAccelerator返回非零值且消息已被翻译,应用程序就不能调用TranslateMessage函数对消息再做处理。每个
加速键不一定都对应于菜单命令。若
加速键命令对应于菜单项,则WM_INITMENU和WM_INITMENUPOPUP消息将被发送到应用程序,就好像用户正试图显示该菜单。然而,如下的任一条件成立时,这些消息将不被发送:窗口被禁止,菜单项被禁止。
编辑本段加强键组合
加速键组合无相应的窗口菜单项且窗口己被最小化。鼠标抓取有效。有关鼠标抓取消息,参看SetCapture函数。若指定的窗口为
活动窗口且窗口无键盘焦点(当窗口最小化时一般是这种情况),
TranslateAccelerator 翻译WM_SYSKEYUP和WM_SYSKEYDOWN消息而不是WM_KEYUP和WM_KEYDOWN消息。
当按下相应于某菜单项的
加速键,而包含该菜单的窗口又已被最小化时,
TranslateAccelerator 不发送WM_COMMAND消息。但是,若按下与
窗口菜单或某单项的任一项均不对应的
加速键时,
TranslateAccelerator将发送一WM_COMMAND消息,即使窗口己被最小化。
Windows CE:所有的
加速键消息被翻译成WM_COMMAND消息;Windows CE不支持WM_SYSCOMMAND消息。
速查:Windows NT:3.1 及以上版本;Windows:95及以上版本:Windows CE:1.0及以上版本;头文件:windows.h;库文件:user32.lib; Unicode:在Windows NT实现为Unicode和ANSI两种版本。