TranslateMessage函式用於將虛擬鍵訊息轉換為字元訊息。
基本介紹
- 中文名：TranslateMessage
- 相關：GetMessage
- 類型：調用函式
- 結構：MSG結構的指針
- 相關學科：計算機
- 輸入庫：user32.lib
基本信息,參數,速查,
基本信息
函式原型：
BOOL TranslateMessage( CONST MSG*lpMsg );
參數
返回值：如果訊息被轉換（即，字元訊息被寄送到調用執行緒的訊息佇列里），返回非零值。如果訊息是WM_KEYDOWN，WM_KEYUP WM_SYSKEYDOWN或WM_SYSKEYUP，返回非零值，不考慮轉換。如果訊息沒被轉換（即，字元訊息沒被寄送到調用執行緒的訊息佇列里），返回值是零。
備註：此函式不修改由參數IpMsg指向的訊息。
WM_KEYDOWN和WM_KEYUP組合產生一個WM_CHAR或WM_DEADCHAR訊息。
WM_SYSKEYDOWN和WM_SYSKEYUP組合產生一個WM_SYSCHAR或 WM_SYSDEADCHAR訊息。TranslateMessage為那些由鍵盤驅動器映射為ASCll字元的鍵產生WM_CHAR訊息。
如果應用程式為其他用途處理虛擬鍵訊息，不應調用TranslateMessage。例如，如果調用TranslateAccelerator返回一個非零值，應用程式不應調用TranslateMessage。
Windows CE：Windows CE不支持掃描碼或擴展鍵標誌，因此，不支持由TranslateMessage產生的WM_CHAR訊息中的IKeyData參數（IParam）取值16-24。
TranslateMessage只能用於轉換調用GetMessage或PeekMessage接收的訊息。
速查
Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；頭檔案：winuser.h；輸入庫：user32.lib。
