碧雪的博客网

版权声明：转载时请以超链接形式标明文章原始出处和作者信息及本声明
http://cibe.yourblog.org/logs/123937.html

2.10 键盘加速器函数（Keyboard Accelerator） 2.10.1 CopyAcceleratorTable 函数功能：拷贝加速键表。拷贝加速键表函数拷贝指定的加速键表。此函数用于获得与一加速键表句柄相对应的加速键表数据，或用于确定加速键表数据的大小。 函数原型：int CopyAcceleratorTable（HACCEL hAccelSrc,LPACCEL IpAcceIDst,int cAccelEntries）； 参数： hAccelSrc:欲拷贝的加速键表的句柄。 IpAccelDst:指向ACCEL结构数组的指针，该结构数组中存在着将要拷贝的加速键表信息。 cAccelEntries:指定由IpAcceIDst参数指向的欲拷贝到缓冲区的ACCEL结构的个数。 返回值：如果IpAccelDst为空，则返回值给出初始加速键表入口的个数。否则，给出己拷贝的加速键表的入口个数。 速查：WindOWS NT：3.1及以上版本：Windows：95及以上版本；Windows CE：不支持；头文件：Winuser.h;库文件：user32.lib；Unicode：在Windows NT上实现为Unicode和ANSI两种版本。 2.10.2 CreateAcceleratorTable 函数功能：创建加速键表。该函数创建一个加速键表。 函数原型：HACCEL CreateAcceleratorTable（LPACCEL lpaccl，int cEntries）； 参数： Ipaccl:指向描述加速键表的ACCEL结构数组的指针。 cEntires:指定数组中ACCEL结构的个数。 返回值：如果函数调用成功，则返回值为所创建的加速键表的句柄；否则，返回值为空。若想获得更多的错误信息，请调用GetLastError。 备注：关闭应用程序之前，必须调用DestroyAcceeleratorTable函数撤消所有由CreatedAccelerstorTable函数创建的加速键表。 速查：Windows NT：3.1u及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：winuser.h;库文件：USer32.lib; Unicode:在Windows NT上实现为Unicode和ANSI两种版本。 2.10.3 DestroyAcceleratorTable 函数功能：撤消加速键表。该函数撤消一个加速键表。在关闭应用程序之前，必须使用该函数撤消所有由DestroyAcceleratorTable函数创建的加速键表。 函数原型: BOOL DestroyAcceleratorTable（HACCEL hAccel）； 参数： hAccdel：将被撤消的加速键表的句柄。该句柄必须己通过调用DestroyAcceleratorTable 函数而创建。 返回值：若函数调用成功，则返回非零值，若函数调用失败，则返回值为零。若要获得更多的错误信息，可以调用GetLastError函数。 速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：Windows.h;库文件：user32.lib。 2.10.4 LoadAccelerators 函数功能：调入加速键表。该函数调入指定的加速键表。 函数原型：HACCEL LoadAccelerators（HINSTANCE hlnstance，LPCTSTR lpTableName）； 参数： hlnstance:模块的一个事例的句柄，该模块的可执行文件中包含将要调入的加速键表。 IpTableName:指向一个以空结尾的字符串的指针，该字符串包含了即将调入的加速键表的名字。另一种可选的方案是，该参数可以在加速键表资源的低位字中指定资源标识符，而高位字中全零。MADEINTRESOURCE宏可被用于创建该值。 返回值：若函数调用成功，则返回非零值。若函数调用失败，则返回值为零。若要获得更多的错误信息，可以调用GetLastError函数。 备注：若加速键表尚未装入，该函数可从指定的可执行文件中将它装入。从资源中装入的加速键表，在程序结束时可自动释放。Windows CE：资源不被拷贝到RAM中，因而不能被修改。 速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h;库文件：user32.lib；Uncode：在Windows NT上实现为Unicode和ANSI两种版本。 2.10.5 TranslateAccelerator 函数功能：翻译加速键表。该函数处理菜单命令中的加速键。该函数将一个WM－DEYDOUN或WM-SYSDEYDOWN消息翻译或一个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函数对消息再做处理。每个加速键不一定都对应于菜单命令。