TranslateAccelerator

 

TranslateAccelerator

 

目录

相关介绍

加强键组合

展开

 

编辑本段相关介绍

函数功能：翻译加速键表。该函数处理菜单命令中的加速键。该函数将一个WM_KEYDOWN或WM_SYSKEYDOWN消息翻译成一个WM_COMMAND或WM_SYSCOMMAND消息（如果在给定的加速键表中有该键的入口），然后将WM_COMMAND或WM_SYSCOMMAND消息直接送到相应的窗口处理过程。

 

TranslateAccelerator直到窗口过程处理完消息后才返回。

 

函数原型：int TranslateAccelerator（HWND hWnd,HACCEL hAccTable，LPMSG IpMsg）;

参数

：

 

hWnd:窗口句柄，该窗口的消息将被翻译。

 

hAccTable:加速键表句柄。加速键表必须由LoadAccelerators函数调用装入或由CreateAccd_eratorTable函数调用创建。

 

LpMsg:MSG结构指针，MSG结构中包含了从使用GetMessage或PeekMessage函数调用线程消息队列中得到的消息内容。

 

返回值：若函数调用成功，则返回非零值；若函数调用失败，则返回值为零。若要获得更多的错误信息，可调用GetLastError函数。

备注

：为了将该函数发送的消息与菜单或控制发送的消息区别开来，使WM_COMMAND或WM_SYSCOMMAND消息的wParam参数的高位字值为1。用于从窗口菜单中选择菜单项的加速键组合被翻译成WM_SYSCOMMAND消息：所有其他的加速键组合被翻译成WM_COMMAND。若TransLateAccelerator返回非零值且消息已被翻译，应用程序就不能调用TranslateMessage函数对消息再做处理。每个加速键不一定都对应于菜单命令。若加速键命令对应于菜单项，则WM_INITMEMU和WM_INITMENUPOPUP消息将被发送到应用程序，就好像用户正试图显示该菜单。然而，如下的任一条件成立时，这些消息将不被发送：窗口被禁止，菜单项被禁止。

 

编辑本段加强键组合

加速键组合无相应的窗口菜单项且窗口己被最小化。鼠标抓取有效。有关鼠标抓取消息，参看SetCapture函数。若指定的窗口为活动窗口且窗口无键盘焦点（当窗口最小化时一般是这种情况），  TranslateAccelerator 翻译WM_SYSDEYUP和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两种版本。