共用方式為


TranslateAcceleratorW 函式 (winuser.h)

處理功能表命令的快速鍵。 函式會將 WM_KEYDOWNWM_SYSKEYDOWN 訊息轉譯為 WM_COMMANDWM_SYSCOMMAND 訊息 (如果指定的快速鍵數據表中有專案) ,然後將 WM_COMMANDWM_SYSCOMMAND 訊息直接傳送至指定的窗口程式。 TranslateAccelerator 在視窗程序處理訊息之前不會傳回。

語法

int TranslateAcceleratorW(
  [in] HWND   hWnd,
  [in] HACCEL hAccTable,
  [in] LPMSG  lpMsg
);

參數

[in] hWnd

類型: HWND

要翻譯訊息之視窗的句柄。

[in] hAccTable

類型: HACCEL

快速鍵數據表的句柄。 快捷鍵數據表必須由 LoadAccelerators 函式的呼叫載入,或是由 CreateAcceleratorTable 函式的呼叫所建立。

[in] lpMsg

類型: LPMSG

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

傳回值

類型: int

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

為了區分此函式從功能表或控制項所傳送的訊息所傳送的訊息,WM_COMMANDWM_SYSCOMMAND訊息的 wParam 參數高序字組包含值 1。

用來從 視窗 功能選取專案的快速鍵組合會轉譯成 WM_SYSCOMMAND 訊息;所有其他快捷鍵組合都會轉譯成 WM_COMMAND 訊息。

TranslateAccelerator 傳回非零值並翻譯訊息時,應用程式不應該使用 TranslateMessage 函式再次處理訊息。

快速鍵不需要對應至功能表命令。

如果快捷鍵命令對應至功能表項,則會傳送 應用程式WM_INITMENUWM_INITMENUPOPUP 訊息,就像使用者嘗試顯示功能表一樣。 不過,如果下列任何條件存在,則不會傳送這些訊息:

  • 視窗已停用。
  • 快速鍵組合不會對應至 視窗 功能表上的專案,而且視窗會最小化。
  • 滑鼠擷取作用中。 如需滑鼠擷取的相關信息,請參閱 SetCapture 函式。
如果指定的視窗是活動視窗,而且沒有視窗具有鍵盤焦點 (,則當視窗最小化) 時, TranslateAccelerator 會轉譯 WM_SYSKEYUPWM_SYSKEYDOWN 訊息,而不是 WM_KEYUPWM_KEYDOWN 訊息。

如果在擁有功能表的視窗最小化時,對應至功能表項的快捷鍵動作, TranslateAccelerator 不會傳送 WM_COMMAND 訊息。 不過,如果快捷鍵擊發生不符合視窗功能表或 視窗 功能表中的任何專案,則函式會傳送 WM_COMMAND 訊息,即使視窗最小化也一樣。

範例

如需範例,請參閱 建立字型屬性的快捷鍵

注意

winuser.h 標頭會將 TranslateAccelerator 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱