Win32 编程基础之鼠标输入

鼠标在窗口内时，鼠标事件发生时窗口会收到客户区消息。当鼠标在客户区内移动鼠标时系统会向窗口投递 WM_MOUSEMOVE 消息。当用户按下或释放鼠标按键时，它会投递以下消息之一。

• WM_LBUTTONDBLCLK，左键双击
• WM_LBUTTONDOWN，左键按下
• WM_LBUTTONUP，左键释放
• WM_MBUTTONDBLCLK，中键双击
• WM_MBUTTONDOWN，中键按下
• WM_MBUTTONUP，中键释放
• WM_RBUTTONDBLCLK，右键双击
• WM_RBUTTONDOWN，右键按下
• WM_RBUTTONUP，右键释放
• WM_XBUTTONDBLCLK，X 键双击
• WM_XBUTTONDOWN，X 键按下
• WM_XBUTTONUP，X 键释放

另外，应用可以使用 TrackMouseEvent 函数让系统发送其他两个消息。当光标在一个某个客户区上悬停超过一段时间后，系统会投递 WM_MOUSEHOVER 消息。当鼠标离开客户区时，系统会投递 WM_MOUSELEAVE 消息。

当鼠标事件发生在窗口除了客户区的部分时，窗口会收到一个非客户区鼠标消息。窗口的非客户区由边框、菜单栏、标题栏、滚动条栏、窗口菜单、最小化按钮和最大化按钮组成。

系统生成非客户区消息以供它自己使用。例如，当光标热点移动到窗口边框时，系统使用非客户区消息来将光标形状改变为一个双箭头。窗口必须将非客户区鼠标消息传递给 DefWindowProc 函数来利用内建的鼠标接口。

对每一个客户区鼠标消息，都有一个与之对应的非客户区鼠标消息。这些消息的名字很相似，除了非客户区消息的开头是 NC 外。例如，在非客户区移动光标会生成 WM_NCMOUSEMOVE 消息，在非客户区按下鼠标左键会生成 WM_NCLBUTTONDOWN 消息。

非客户区消息的 lParam 参数是一个包含鼠标热点 x 和 y 坐标的结构。与客户区鼠标消息的坐标轴不同，这个坐标轴是屏幕坐标轴而不是客户坐标轴。在屏幕坐标系统中，所有的点的原点是屏幕的左上角。

wParam 包含着点击测试（hit-test）值，它指明了非客户区鼠标事件的发生地。

应用应该使用 SystemParametersInfo 函数来检索每个滚动操作（每个凹口）所造成的滚动行数。要检索行数，应用可以这样调用：

SystemParametetsInfo(SPI_GETWHELLSCROLLLINES, 0, pulScrollLines, 0);

变量 pulScrollLines 指向一个无符号整数，它用来接收建议的滚动行数。

• 如果值为 0，不应该进行滚动
• 如果值为 WHELL_PAGESCROLL ，滚轮的滚动应该被解释为滚动条的 page down 或 page up
• 如果值大于可见行数，滚动操作应该被解释为翻页操作

滚动行数的默认值为 3。如果用户通过控制面板中的鼠标属性页改变了滚动行数，操作系统会对所有的顶级窗口广播 WM_SETTINGCHANGE 消息，并在其中指定 SPI_SETWHELLSCROLLLINES 。当应用接收到了该消息，它应该这样来取得新的滚动行数：

SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, pulScrollLines, 0);

要判断鼠标有没有滚轮，可以使用 SM_MOUSEWHEELPRESENT 标志调用 GetSystemMetrics。返回 TRUE 则说明鼠标连接了。

鼠标滚轮的消息是 WM_MOUSEWHEEL ，它的 wParam 高位字是滚轮滚动的距离，以 WHEEL_DELTA 的整数倍表示，它的值是 120。这个值是正数说明滚轮向前滚动，远离用户；是负数则说明滚轮向后滚动，朝向用户。（负值向下滚，正值向上滚）

wParam 的低位字指明虚拟键是否按下。 lParam 是鼠标的位置。

使用以下代码来获得滚动距离和其他按键状态：

fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);

使用以下代码获得鼠标的坐标值：

xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam)

使用 SystemParametersInfo 函数可以获取一次滚轮需要滚动的行数。使用 WHELL_DELTA 除以获得的值就是每滚动一行所需要的滚动距离。

在示例程序中，我使用了一个包含从 0 - 999 的数字的字符串指针，以这 1000 个字符串作为显示的内容。字符串的变量定义和初始化函数如下所示：

char Nums[1000][4];

void GenZero2Thousand(char a[][4])
{
    for (int i = 0; i < 1000; i++)
    {
        _itoa_s(i, a[i], 4, 10);
    }
}

下面是窗口过程函数，使用 ScrollWindow 来滚动屏幕

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    static int cxSize;
    static int cySize;
    static int cyLines;
    static int cyChar;
    static int icurrStLine;
    static int iDeltaPerLine;
    static int iAccuDelta;
    static RECT rect;
    ULONG ulScrollLines;
    TEXTMETRIC tm;
    HDC hdc;
    switch (message)
    {
    case WM_CREATE:
        GenZero2Thousand(Nums);
        hdc = GetDC(hWnd);
        GetTextMetrics(hdc, &tm);
        cyChar = tm.tmHeight + tm.tmExternalLeading;
        ReleaseDC(hWnd, hdc);

        SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, &ulScrollLines, 0);
        if (ulScrollLines)
        {
            iDeltaPerLine = WHEEL_DELTA / ulScrollLines;
        }
        else
        {
            iDeltaPerLine = 0;
        }
        return 0;

    case WM_SIZE:
        cxSize = LOWORD(lParam);
        cySize = HIWORD(lParam);
        cyLines = cySize / cyChar;
        GetClientRect(hWnd, &rect);
        rect.bottom = cyChar * cyLines;
        return 0;

    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hWnd, &ps);
            for (int i = 0; i < cyLines; i++)
            {
                TextOutA(hdc, 0, cyChar * i, Nums[i + icurrStLine], strlen(Nums[i + icurrStLine]));
            }
            EndPaint(hWnd, &ps);
        }
        break;

    case MY_MOVE:
        if (wParam == 1)
        {
            if (icurrStLine == 0)
                break;
            icurrStLine -= 1;
            ScrollWindow(hWnd, 0, cyChar, &rect, &rect);
            ValidateRect(hWnd, NULL);
            hdc = GetDC(hWnd);
            TextOutA(hdc, 0, 0, "       ", 7);
            TextOutA(hdc, 0, 0, Nums[icurrStLine], strlen(Nums[icurrStLine]));
            ReleaseDC(hWnd, hdc);
        }
        else if (wParam == -1)
        {
            if (icurrStLine == 1000 - cyLines)
                break;
            icurrStLine += 1;
            ScrollWindow(hWnd, 0, -cyChar, &rect, &rect);
            hdc = GetDC(hWnd);
            TextOutA(hdc, 0, cyChar * (cyLines - 1), Nums[icurrStLine + cyLines - 1], strlen(Nums[icurrStLine + cyLines - 1]));
            ReleaseDC(hWnd, hdc);
            ValidateRect(hWnd, NULL);

        }
        break;
    case WM_MOUSEWHEEL:
        if (iDeltaPerLine == 0)
            break;
        iAccuDelta += (short)GET_WHEEL_DELTA_WPARAM(wParam);
        while (iAccuDelta >= iDeltaPerLine)
        {
            SendMessage(hWnd, MY_MOVE, 1, 0);
            iAccuDelta -= iDeltaPerLine;
        }

        while (iAccuDelta <= -iDeltaPerLine)
        {
            SendMessage(hWnd, MY_MOVE, -1, 0);
            iAccuDelta += iDeltaPerLine;
        }
        return 0;


    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

编译并运行，可以看到客户区上的数字，滚动滚轮，可以上下移动，最多到 999。

悬停消息，顾名思义，当鼠标在窗口区域停留一段事件后会触发该事件。离开消息即是鼠标离开某个窗口时触发的事件。

使用 WM_MOUSEHOVER 和 WM_MOUSELEAVE 消息前，需要调用 TrackMouseEvent 函数来让窗口能够接收这两个消息。

TrackMouseEvent 函数接收一个叫做 TRACKMOUSEEVENT 的结构的指针，它的组成如下所示：

typedef struct tagTRACKMOUSEEVENT {
  DWORD cbSize;
  DWORD dwFlags;
  HWND  hwndTrack;
  DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;

成员 cbSize 是结构的大小，即 sizeof(TRACKMOUSEEVENT) 。

成员 dwFlags 用来指定所需要的服务，它的值可以是以下值的组合：

• TME_CANCEL ，表示调用者想要取消先前的追踪请求，调用者应该同事指定想要取消的追踪的类型，例如，想要取消悬停追踪，调用者必须指定 TME_CANCEL 和 TME_HOVER 。
• TME_HOVER ，表示调用者想要追踪悬停消息。通知以 WM_MOUSEHOVER 消息发送。如果悬停追踪已经处于活跃状态，再次使用这个标志调用函数会重设计时器。如果鼠标指针不在窗口或区域上，这个标志会被忽略。
• TME_LEAVE ，调用者想要鼠标离开的通知。通知使用 WM_MOUSELEAVE 消息发送。如果鼠标不在指定窗口或区域，离开通知会被立即生成，并且不会再进行追踪。
• TME_NONCLIENT ，调用者想要不在客户区的悬停和离开消息。这些通知以 WM_NCMOUSEHOVER 和 WM_NCMOUSELEAVE 发送。
• TME_QUERY ，函数会填充这个结构，而不是使用它来作为追踪请求。

成员 hwndTrack 是想要追踪的窗口的句柄

成员 dwHoverTime 是悬停的要求时间（time-out），以毫秒为单位。它可是使用 HOVER_DEFAULT 来指定系统默认的悬停时间。

以下代码的逻辑即：当鼠标进入窗口时，调用 TrackMouseEvent 以捕捉悬停消息，发现悬停后会在客户区打印 In。此后，调用 TrackMouseEvent 以追踪离开消息，当鼠标离开后打印 Out。

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    HDC hdc;
    static BOOL fin = FALSE;
    static BOOL ftrack = FALSE;
    TRACKMOUSEEVENT tme;
    switch (message)
    {
    case WM_MOUSEMOVE:
        if (!ftrack)
        {
            if (!fin)
            {
                tme.cbSize = sizeof(tme);
                tme.dwFlags = TME_HOVER;
                tme.hwndTrack = hWnd;
                tme.dwHoverTime = HOVER_DEFAULT;
                TrackMouseEvent(&tme);
                ftrack = TRUE;
            }
            else
            {
                tme.cbSize = sizeof(tme);
                tme.dwFlags = TME_LEAVE;
                tme.hwndTrack = hWnd;
                tme.dwHoverTime = 0;
                TrackMouseEvent(&tme);
                ftrack = TRUE;
            }
        }
        return 0;
    case WM_MOUSEHOVER:
        hdc = GetDC(hWnd);
        TextOut(hdc, 0, 0, TEXT("                "), 16);
        TextOut(hdc, 0, 0, TEXT("In"), 2);
        fin = TRUE;
        ftrack = FALSE;
        return 0;
    case WM_MOUSELEAVE:
        hdc = GetDC(hWnd);
        TextOut(hdc, 0, 0, TEXT("                "), 16);
        TextOut(hdc, 0, 0, TEXT("OUT"), 3);
        fin = FALSE;
        ftrack = FALSE;
        return 0;
    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hWnd, &ps);
            EndPaint(hWnd, &ps);
        }
        break;
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

把鼠标在窗口上移进移出，就可以看见客户区的左上角的单词的不断变化。