DispatchMessageW 函式 (winuser.h)
將訊息分派至視窗程式。 它通常用來分派由 getMessage 函式
語法
LRESULT DispatchMessageW(
[in] const MSG *lpMsg
);
參數
[in] lpMsg
類型:const MSG*
包含訊息之結構的指標。
傳回值
類型:LRESULT
傳回值會指定視窗程式所傳回的值。 雖然其意義取決於正在分派的訊息,但通常會忽略傳回值。
言論
MSG 結構必須包含有效的訊息值。 如果 lpmsg 參數指向 WM_TIMER 訊息,且 WM_TIMER 訊息的 lParam 參數不是 NULL,lParam 指向呼叫的函式,而不是窗口程式。
請注意,應用程式負責擷取和分派輸入訊息至對話方塊。 大部分的應用程式都會為此使用主要訊息迴圈。 不過,若要允許使用者移至 並使用鍵盤來選取控件,應用程式必須呼叫 IsDialogMessage。 如需詳細資訊,請參閱 對話框鍵盤介面。
例子
如需範例,請參閱 建立訊息循環。
注意
winuser.h 標頭會將 DispatchMessage 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | winuser.h (包括 Windows.h) |
連結庫 | User32.lib |
DLL | User32.dll |
API 集 | ext-ms-win-ntuser-message-l1-1-0 (在 Windows 8 中引進) |
另請參閱
概念
參考