使用訊息和訊息佇列
下列程式碼範例示範如何執行與 Windows 訊息和訊息佇列相關聯的下列工作。
建立訊息迴圈
系統不會為每個執行緒自動建立訊息佇列。 相反地，系統只會針對執行需要訊息佇列之作業的執行緒建立訊息佇列。 如果執行緒建立一或多個視窗，則必須提供訊息迴圈;此訊息迴圈會從執行緒的訊息佇列擷取訊息，並將其分派至適當的視窗程式。
由於系統會將訊息導向應用程式中的個別視窗，執行緒必須在啟動其訊息迴圈之前建立至少一個視窗。 大部分的應用程式都包含建立視窗的單一線程。 一般應用程式會為其主視窗註冊視窗類別、建立並顯示主視窗，然後啟動其訊息迴圈 ，全都在 WinMain 函 式中。
您可以使用 GetMessage 和 DispatchMessage 函式來建立訊息迴圈。 如果您的應用程式必須從使用者取得字元輸入，請在迴圈中包含 TranslateMessage 函式。 TranslateMessage 會將虛擬金鑰訊息轉譯為字元訊息。 下列範例顯示簡單 Windows 應用程式 之 WinMain 函 式中的訊息迴圈。
HINSTANCE hinst;
HWND hwndMain;
int PASCAL WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpszCmdLine, int nCmdShow)
{
MSG msg;
BOOL bRet;
WNDCLASS wc;
UNREFERENCED_PARAMETER(lpszCmdLine);
// Register the window class for the main window.
if (!hPrevInstance)
{
wc.style = 0;
wc.lpfnWndProc = (WNDPROC) WndProc;
wc.cbClsExtra = 0;
wc.cbWndExtra = 0;
wc.hInstance = hInstance;
wc.hIcon = LoadIcon((HINSTANCE) NULL,
IDI_APPLICATION);
wc.hCursor = LoadCursor((HINSTANCE) NULL,
IDC_ARROW);
wc.hbrBackground = GetStockObject(WHITE_BRUSH);
wc.lpszMenuName = "MainMenu";
wc.lpszClassName = "MainWndClass";
if (!RegisterClass(&wc))
return FALSE;
}
hinst = hInstance; // save instance handle
// Create the main window.
hwndMain = CreateWindow("MainWndClass", "Sample",
WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT,
CW_USEDEFAULT, CW_USEDEFAULT, (HWND) NULL,
(HMENU) NULL, hinst, (LPVOID) NULL);
// If the main window cannot be created, terminate
// the application.
if (!hwndMain)
return FALSE;
// Show the window and paint its contents.
ShowWindow(hwndMain, nCmdShow);
UpdateWindow(hwndMain);
// Start the message loop.
while( (bRet = GetMessage( &msg, NULL, 0, 0 )) != 0)
{
if (bRet == -1)
{
// handle the error and possibly exit
}
else
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
// Return the exit code to the system.
return msg.wParam;
}
下列範例顯示使用快速鍵並顯示無強制回應對話方塊之執行緒的訊息迴圈。 當 TranslateAccelerator 或 IsDialogMessage 傳回 TRUE (指出訊息已處理) ，則不會呼叫 TranslateMessage 和 DispatchMessage 。 這是因為 TranslateAccelerator 和 IsDialogMessage 會執行所有必要的翻譯和分派訊息。
HWND hwndMain;
HWND hwndDlgModeless = NULL;
MSG msg;
BOOL bRet;
HACCEL haccel;
//
// Perform initialization and create a main window.
//
while( (bRet = GetMessage( &msg, NULL, 0, 0 )) != 0)
{
if (bRet == -1)
{
// handle the error and possibly exit
}
else
{
if (hwndDlgModeless == (HWND) NULL ||
!IsDialogMessage(hwndDlgModeless, &msg) &&
!TranslateAccelerator(hwndMain, haccel,
&msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
}
檢查訊息佇列
有時候，應用程式需要從執行緒的訊息迴圈外部檢查執行緒訊息佇列的內容。 例如，如果應用程式的視窗程式執行冗長的繪圖作業，您可能希望使用者能夠中斷作業。 除非您的應用程式在滑鼠和鍵盤訊息的作業期間定期檢查訊息佇列，否則在作業完成後才會回應使用者輸入。 這是因為執行緒訊息迴圈中的 DispatchMessage 函式在視窗程式完成處理訊息之前不會傳回。
您可以使用 PeekMessage 函式在冗長的作業期間檢查訊息佇列。 PeekMessage 類似于 GetMessage 函式;兩者都會檢查訊息佇列中是否有符合篩選準則的訊息，然後將訊息複製到 MSG 結構。 這兩個函式的主要差異在於 GetMessage 在符合篩選準則的訊息放在佇列中之前不會傳回， 而 PeekMessage 則會立即傳回，而不論訊息是否在佇列中。
下列範例示範如何使用 PeekMessage 在冗長的作業期間檢查滑鼠點選和鍵盤輸入的訊息佇列。
HWND hwnd;
BOOL fDone;
MSG msg;
// Begin the operation and continue until it is complete
// or until the user clicks the mouse or presses a key.
fDone = FALSE;
while (!fDone)
{
fDone = DoLengthyOperation(); // application-defined function
// Remove any messages that may be in the queue. If the
// queue contains any mouse or keyboard
// messages, end the operation.
while (PeekMessage(&msg, hwnd, 0, 0, PM_REMOVE))
{
switch(msg.message)
{
case WM_LBUTTONDOWN:
case WM_RBUTTONDOWN:
case WM_KEYDOWN:
//
// Perform any required cleanup.
//
fDone = TRUE;
}
}
}
其他函式，包括 GetQueueStatus 和 GetInputState，也可讓您檢查執行緒訊息佇列的內容。 GetQueueStatus 會傳回旗標陣列，指出佇列中的訊息類型;使用它是探索佇列是否包含任何訊息的最快方式。 如果佇列包含滑鼠或鍵盤訊息，GetInputState會傳回TRUE。 這兩個函式都可以用來判斷佇列是否包含需要處理的訊息。
張貼訊息
您可以使用 PostMessage 函式將訊息張貼至訊息佇列。 PostMessage 會將訊息放線上程訊息佇列的結尾，並立即傳回，而不需要等待中的執行緒處理訊息。 函式的參數包括視窗控制碼、訊息識別碼和兩個訊息參數。 系統會將這些參數複製到 MSG 結構、填滿結構 的時間 和 pt 成員，並將結構放在訊息佇列中。
系統會使用與 PostMessage 函式一起傳遞的視窗控制碼，來判斷應該接收訊息的執行緒訊息佇列。 如果控制碼 HWND_TOPMOST，系統會將訊息張貼到所有頂層視窗的執行緒訊息佇列。
您可以使用 PostThreadMessage 函式，將訊息張貼至特定的執行緒訊息佇列。 PostThreadMessage 類似于 PostMessage，但第一個參數是執行緒識別碼，而不是視窗控制碼。 您可以呼叫 GetCurrentThreadId 函式來擷取執行緒識別碼。
使用 PostQuitMessage 函式結束訊息迴圈。 PostQuitMessage 會將 WM_QUIT 訊息張貼到目前執行的執行緒。 執行緒的訊息迴圈會在遇到 WM_QUIT 訊息時終止，並將控制權傳回給系統。 應用程式通常會呼叫 PostQuitMessage 以回應 WM_DESTROY 訊息，如下列範例所示。
case WM_DESTROY:
// Perform cleanup tasks.
PostQuitMessage(0);
break;
傳送訊息
SendMessage函式可用來將訊息直接傳送至視窗程式。 SendMessage 會呼叫視窗程式，並等候該程式處理訊息並傳回結果。
訊息可以傳送至系統中的任何視窗;只需要視窗控制碼。 系統會使用 控制碼來判斷應該接收訊息的視窗程式。
在處理可能已從另一個執行緒傳送的訊息之前，視窗程式應該先呼叫 InSendMessage 函式。 如果此函式傳回 TRUE，則視窗程式應該在造成執行緒產生控制權的任何函式之前呼叫 ReplyMessage ，如下列範例所示。
case WM_USER + 5:
if (InSendMessage())
ReplyMessage(TRUE);
DialogBox(hInst, "MyDialogBox", hwndMain, (DLGPROC) MyDlgProc);
break;
一些訊息可以傳送至對話方塊中的控制項。 這些控制項訊息會設定控制項的外觀、行為和內容，或擷取控制項的相關資訊。 例如， CB_ADDSTRING 訊息可以將字串新增至下拉式方塊，而 BM_SETCHECK 訊息可以設定核取方塊或選項按鈕的核取狀態。
使用 SendDlgItemMessage 函式將訊息傳送至控制項，並指定控制項的識別碼，以及包含控制項之對話方塊視窗的控制碼。 下列範例取自對話方塊程式，會將下拉式方塊的編輯控制項中的字串複製到其清單方塊中。 此範例使用 SendDlgItemMessage 將 CB_ADDSTRING 訊息傳送至下拉式方塊。
HWND hwndCombo;
int cTxtLen;
PSTR pszMem;
switch (uMsg)
{
case WM_COMMAND:
switch (LOWORD(wParam))
{
case IDD_ADDCBITEM:
// Get the handle of the combo box and the
// length of the string in the edit control
// of the combo box.
hwndCombo = GetDlgItem(hwndDlg, IDD_COMBO);
cTxtLen = GetWindowTextLength(hwndCombo);
// Allocate memory for the string and copy
// the string into the memory.
pszMem = (PSTR) VirtualAlloc((LPVOID) NULL,
(DWORD) (cTxtLen + 1), MEM_COMMIT,
PAGE_READWRITE);
GetWindowText(hwndCombo, pszMem,
cTxtLen + 1);
// Add the string to the list box of the
// combo box and remove the string from the
// edit control of the combo box.
if (pszMem != NULL)
{
SendDlgItemMessage(hwndDlg, IDD_COMBO,
CB_ADDSTRING, 0,
(DWORD) ((LPSTR) pszMem));
SetWindowText(hwndCombo, (LPSTR) NULL);
}
// Free the memory and return.
VirtualFree(pszMem, 0, MEM_RELEASE);
return TRUE;
//
// Process other dialog box commands.
//
}
//
// Process other dialog box messages.
//
}
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應