MSG
Windows程序中的結構體
MSG是Windows程序中的結構體。在Windows程序中,消息是由MSG結構體來表示的。成員變數含義:第一個成員變數hwnd表示消息所屬的窗口;第二個成員變數message指定了消息的標識符。第三、第四個成員變數wParam和lParam,用於指定消息的附加信息。最後兩個變數分別表示消息投遞到消息隊列中的時間和滑鼠的當前位置。
目錄
在Windows程序中,消息是由MSG結構體來表示的。MSG結構體的定義如下(參見MSDN):
typedef struct tagMSG {
HWND hwnd;
UINT message;
WPARAM wParam;
LPARAM lParam;
DWORD time;
POINT pt;
} MSG;
該結構體中各成員變數的含義如下:
第一個成員變數hwnd表示消息所屬的窗口。我們通常開發的程序都是窗口應用程序,一個消息一般都是與某個窗口相關聯的。例如,在某個活動窗口中按下滑鼠左鍵,產生的按鍵消息就是發給該窗口的。在Windows程序中,用HWND類型的變數來標識窗口。
第二個成員變數message指定了消息的標識符。在Windows中,消息是由一個數值來表示的,不同的消息對應不同的數值。但是由於數值不便於記憶,所以Windows將消息對應的數值定義為WM_XXX宏(WM是Window Message的縮寫)的形式,XXX對應某種消息的英文拼寫的大寫形式。例如,滑鼠左鍵按下消息是WM_LBUTTONDOWN,鍵盤按下消息是WM_KEYDOWN,字元消息是WM_CHAR,等等。在程序中我們通常都是以WM_XXX宏的形式來使用消息的。
提示:如果想知道WM_XXX消息對應的具體數值,可以在Visual C++開發環境中選中WM_XXX,然後單擊滑鼠右鍵,在彈出菜單中選擇goto definition,即可看到該宏的具體定義。跟蹤或查看某個變數的定義,都可以使用這個方法。
第三、第四個成員變數wParam和lParam,用於指定消息的附加信息。例如,當我們收到一個字元消息的時候,message成員變數的值就是WM_CHAR,但用戶到底輸入的是什麼字元,那麼就由wParam和lParam來說明。wParam、lParam表示的信息隨消息的不同而不同。如果想知道這兩個成員變數具體表示的信息,可以在MSDN中關於某個具體消息的說明文檔查看到。讀者可以在VC++的開發環境中通過goto definition查看一下WPARAM和LPARAM這兩種類型的定義,可以發現這兩種類型實際上就是unsigned int和long。
最後兩個變數分別表示消息投遞到消息隊列中的時間和滑鼠的當前位置。
hwnd
Identifies the window whose window procedure receives the message.
message
Specifies the message number.
wParam
Specifies additional information about the message.
lParam
Specifies additional information about the message. The exact meaning depends on the value of the message member.
time
Specifies the time at which the message was posted.
pt
Specifies the cursor position, in screen coordinates, when the message was posted.
minigui
在 MiniGUI 中,消息被如下定義(include/window.h):
352 typedef struct _MSG
353 {
354 HWND hwnd;
355 int message;
356 WPARAM wParam;
357 LPARAM lParam;
358 #ifdef _LITE_VERSION
359 unsigned int time;
360 #else
361 struct timeval time;
362 #endif
363 POINT pt;
364 #ifndef _LITE_VERSION
365 void* pAdd;
366 #endif
367 }MSG;
368 typedef MSG* PMSG;
一個消息由該消息所屬的窗口(hwnd)、消息編號(message)、消息的 WPARAM 型參數(wParam)連同消息的 LPARAM 型參數(lParam)組成。消息的兩個參數中包含了重要的內容。比如,對滑鼠消息而言,lParam 中一般包含滑鼠的位置信息,而 wParam 參數中則包含發生該消息時,對應的 SHIFT 鍵的狀態信息等。對其他不同的消息類型來講,wParam 和 lParam 也具備明確的定義。當然,用戶也能夠自定義消息,並定義消息的 wParam 和 lParam 意義。為了用戶能夠自定義消息,MiniGUI 定義了 MSG_USER 宏,可如下定義自己的消息:
#define MSG_MYMESSAGE1 (MSG_USER + 1)
#define MSG_MYMESSAGE2 (MSG_USER + 2)