Windows API一日一練(13)TranslateMessage函數

TranslateMessage是用來把虛擬鍵訊息轉換為字元訊息。由於Windows對所有鍵盤編碼都是採用虛擬鍵的定義，這樣當按鍵按下時，並不得字元訊息，需要鍵盤對應轉換為字元的訊息。
TranslateMessage函數用於將虛擬鍵訊息轉換為字元訊息。字元訊息被投遞到調用線程的訊息佇列中，當下一次調用GetMessage函數時被取出。當我們敲擊鍵盤上的某個字元鍵時，系統將產生WM_KEYDOWN和WM_KEYUP訊息。這兩個訊息的附加參數（wParam和lParam）包含的是虛擬按鍵碼和掃描碼等資訊，而我們在程式中往往需要得到某個字元的ASCII碼，TranslateMessage這個函數就可以將WM_KEYDOWN和WM_ KEYUP訊息的組合轉換為一條WM_CHAR訊息（該訊息的wParam附加參數包含了字元的ASCII碼），並將轉換後的新訊息投遞到調用線程的訊息佇列中。注意，TranslateMessage函數並不會修改原有的訊息，它只是產生新的訊息並投遞到訊息佇列中。
也就是說TranslateMessage會發現訊息裡是否有字元鍵的訊息，如果有字元鍵的訊息，就會產生WM_CHAR訊息，如果沒有就會產生什麼訊息。
 
函數TranslateMessage聲明如下：
WINUSERAPI
BOOL
WINAPI
TranslateMessage(
    __in CONST MSG *lpMsg);
lpMsg是檢查需要轉換的訊息。
 
調用這個函數的例子如下：
#001 //主程式入口
#002 //
#003 // 蔡軍生 2007/07/19
#004 // QQ: 9073204
#005 //
#006 int APIENTRY _tWinMain(HINSTANCE hInstance,
#007                       HINSTANCE hPrevInstance,
#008                       LPTSTR    lpCmdLine,
#009                       int       nCmdShow)
#010 {
#011  UNREFERENCED_PARAMETER(hPrevInstance);
#012  UNREFERENCED_PARAMETER(lpCmdLine);
#013
#014   //
#015  MSG msg;
#016  HACCEL hAccelTable;
#017
#018  // 載入全域字串。
#019  LoadString(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
#020  LoadString(hInstance, IDC_TESTWIN, szWindowClass, MAX_LOADSTRING);
#021  MyRegisterClass(hInstance);
#022
#023  // 應用程式初始化:
#024  if (!InitInstance (hInstance, nCmdShow))
#025  {
#026         return FALSE;
#027  }
#028
#029  hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDC_TESTWIN));
#030
#031  // 訊息迴圈:
#032  BOOL bRet;
#033  while ( (bRet = GetMessage(&msg, NULL, 0, 0)) != 0)
#034  {
#035          if (bRet == -1)
#036         {
#037               //處理出錯。
#038
#039         }
#040         else if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
#041         {
#042               TranslateMessage(&msg);
#043               DispatchMessage(&msg);
#044         }
#045  }
#046
#047  return (int) msg.wParam;
#048 }
#049
 
第42行是調用函數TranslateMessage作訊息轉換工作

本文來自CSDN部落格，轉載請標明出處：http://blog.csdn.net/caimouse/archive/2007/07/23/1702420.aspx

 

 

函數功能描述:將虛擬鍵訊息轉換為字元訊息。字元訊息被送到調用線程的訊息佇列中，在下一次線程調用函數GetMessage或PeekMessage時被讀出。

.函數原型：
    BOOL TranslateMessage(  CONST MSG *lpMsg );.參數：
    lpMsg
        指向一個含有用GetMessage或PeekMessage函數從調用線程的訊息佇列中取得訊息資訊的MSG結構的指標。.傳回值：
    如果訊息被轉換（即，字元訊息被送到線程的訊息佇列中），返回非零值。
    如果訊息是 WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN, 或 WM_SYSKEYUP，返回非零值，不考慮轉換。
    如果訊息沒有轉換（即，字元訊息沒被送到線程的訊息佇列中），傳回值是零。.備忘：
    TranslateMessage函數不修改由參數lpMsg指向的訊息。
    訊息WM_KEYDOWN和WM_KEYUP組合產生一個WM_CHAR或WM_DEADCHAR訊息。訊息WM_SYSKEYDOWN和WM_SYSKEYUP組合產生一個WM_SYSCHAR或 WM_SYSDEADCHAR 訊息。
    TtanslateMessage僅為那些由鍵盤磁碟機映射為ASCII字元的鍵產生WM_CHAR訊息。
    如果應用程式為其它用途而處理虛擬鍵訊息，不應調用TranslateMessage函數。例如，如果TranslateAccelerator函數返回一個非零值，則應用程式將不調用TranslateMessage函數。
    Windows CE：Windows CE不支援掃描碼或擴充鍵標誌，因此，它不支援由TranslateMessage函數產生的WM_CHAR訊息中的lKeyData參數（lParam）16-24的取值。
    TranslateMessage函數只能用於轉換由GetMessage或PeekMessage函數接收到的訊息。 

 

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1632241