TranslateMessage 函式 (winuser.h)

  • 發行項

將虛擬金鑰訊息轉譯為字元訊息。 字元訊息會張貼至呼叫線程的訊息佇列，下次線程呼叫 GetMessage 或 PeekMessage 函式時要讀取。

語法

BOOL TranslateMessage(
  [in] const MSG *lpMsg
);

參數

[in] lpMsg

類型： const MSG*

MSG 結構的指標，其中包含使用 GetMessage 或 PeekMessage 函式從呼叫線程消息佇列擷取的訊息資訊。

傳回值

類型： BOOL

如果訊息轉譯 (，則會將字元訊息張貼至線程的訊息佇列) ，傳回值為非零。

如果訊息 是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 訊息。

TranslateMessage 只會針對鍵盤驅動程序對應至 ASCII 字元的按鍵產生 WM_CHAR 訊息。

如果應用程式針對其他用途處理虛擬密鑰訊息，則不應該呼叫 TranslateMessage。 例如，如果 TranslateAccelerator 函式傳回非零值，應用程式就不應該呼叫 TranslateMessage。 請注意，應用程式負責擷取和分派輸入訊息至對話方塊。 大部分的應用程式都會針對此使用主要訊息迴圈。 不過，若要允許使用者移至 並使用鍵盤選取控件，應用程式必須呼叫 IsDialogMessage。 如需詳細資訊，請參閱 對話框鍵盤介面。

範例

如需範例，請參閱 建立訊息迴圈。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-message-l1-1-0 (於 Windows 8)

另請參閱