WPARAM詳解

在Win API編程中，WPARAM是一個很重要的數據類型，它被廣泛使用在消息處理函數中。它表示一個32位的數值，用於傳遞消息的參數。在這篇文章中，將從多個方面對WPARAM進行詳細的闡述。

一、使用WPARAM表示消息

在Win API中，消息是由一個整型值來代表的，這個值被稱為消息類型。當一個窗口收到某個消息時，它會調用對應的消息處理函數進行處理。在消息處理函數中，通常會用到WPARAM這個參數。它表示消息的附加信息，具體的消息和對應的WPARAM參數可以在WinUser.h中的定義中看到。下面以WM_COMMAND和WM_NOTIFY消息為例進行說明：

case WM_COMMAND:
    {
        int wmId = LOWORD(wParam);
        // wmId就是這個消息所代表的控制項的ID號
        switch (wmId)
        {
        case IDM_ABOUT:
            // 這裡插入彈出「關於」對話框的代碼
            break;
        case IDM_EXIT:
            // 這裡插入關閉窗口的代碼
            break;
        default:
            return DefWindowProc(hWnd, message, wParam, lParam);
        }
        break;
    }
case WM_NOTIFY:
    {
        NMHDR* pnmh = (NMHDR*)lParam;
        switch (pnmh->code)
        {
        case LVN_ITEMCHANGED:
            {
                LPNMLISTVIEW pnmlv = reinterpret_cast(lParam);
                // pnmlv->uNewState中包含當前項的狀態，可以用來控制按鈕的狀態
                break;
            }
        default:
            return DefWindowProc(hWnd, message, wParam, lParam);
        }
        break;
    }

代碼中，WM_COMMAND消息用於處理從菜單、工具條或加速鍵發送的命令消息，它的wParam參數表示的是控制項的ID號。WM_NOTIFY消息用於處理通知消息，必須由一個控制項發出，它的wParam參數一般不含實際信息，需要通過lParam參數來取得詳細信息。

二、使用WPARAM傳遞數據

除了代表消息外，WPARAM還可以用來傳遞一些數據。在這種情況下，我們通常會把它當作一個整型來使用。比如，在SendMessage函數中使用WPARAM參數可以傳遞一個指針，用於將消息的返回結果存儲在該指針指向的內存中。另外，在使用PostMessage函數向消息隊列中發送一個消息時，我們也可以在wParam中傳入自定義的值。

// 以傳遞指針為例
case WM_MYMESSAGE:
    {
        DWORD* pdwData = (DWORD*)wParam;
        DWORD dwValue = *pdwData;
        // 處理數據
        *pdwData = dwNewValue;
        break;
    }

代碼中，我們通過將DWORD類型的數據轉換為DWORD*指針來傳遞數據。注意，這裡需要自行管理指針所指向的內存，以確保程序的正確性。

三、使用WPARAM進行位運算

WPARAM是一個32位的無符號整數，它可以用於進行位運算。在開發過程中，有時會需要判斷消息的某些標誌是否被設置，這時候我們就可以使用WPARAM進行一些位運算操作。

case WM_MYMESSAGE:
    {
        BOOL bFlag1 = (BOOL)(wParam & FLAG1);
        BOOL bFlag2 = (BOOL)(wParam & FLAG2);
        BOOL bFlag3 = (BOOL)(wParam & FLAG3);
        // 檢測標誌是否被設置
        if (bFlag1)
        {
            // 處理某個標誌
        }
        // ...
        break;
    }

在代碼中，我們使用位運算符&來檢測消息標記是否被設置。每一個標誌都是一個2的冪次方，一般使用常量來定義，以方便調用。

四、使用WPARAM控制應用程序行為

除了上述應用場景，WPARAM還可以用於控制應用程序的行為。在這種情況下，我們可以把WPARAM看作一個代表命令的數值。例如，在ListView控制項中，我們可以使用WPARAM來控制每個項的狀態。

case WM_COMMAND:
    {
        int wmId = LOWORD(wParam);
        switch (wmId)
        {
        case IDM_CLICK:
            {
                // 反轉當前項的狀態
                LVITEM lvItem = {0};
                lvItem.iItem = ListView_GetSelectionMark(hwndList);
                lvItem.stateMask = LVIS_STATEIMAGEMASK;
                ListView_GetItem(hwndList, &lvItem);
                lvItem.state ^= INDEXTOSTATEIMAGEMASK(1);
                ListView_SetItem(hwndList, &lvItem);
                break;
            }
        // ...
        }
    }

在代碼中，我們通過使用位運算來改變ListView控制項中每個項的狀態。我們使用LVITEM結構體來表示每個項的狀態，使用ListView_GetItem函數獲取該項的狀態，使用ListView_SetItem函數進行設置。

五、總結

在這篇文章中，我們對WPARAM這個在Win API編程中使用頻率非常高的參數進行了詳細的講解。我們從多個方面對WPARAM進行了闡述，包括用作消息表示、傳遞數據、進行位運算以及控制應用程序行為等多個方面。通過對WPARAM的深入理解，我們可以更好地開發出高效、可靠的Windows應用程序。