【转】Windows编程之滚动条—滚动条消息

ゞ浴缸里的玫瑰 2022-10-22 04:20 392阅读 0赞

在用鼠标单击滚动条或者拖动卷动方块时，Windows给窗口消息处理程序发送WM\_VSCROLL（供上下移动）和WM\_HSCROLL（供左右移动）消息。在滚动条上的每个鼠标动作都至少产生两个消息，一条在按下鼠标按钮时产生，一条在释放按钮时产生。

和所有的消息一样，WM\_VSCROLL和WM\_HSCROLL也带有wParam和lParam消息参数。对于来自作为窗口的一部分而建立的滚动条消息，您可以忽略lParam；它只用于作为子窗口而建立的滚动条（通常在对话框内）。

wParam消息参数被分为一个低字组和一个高字组。wParam的低字组是一个数值，它指出了鼠标对滚动条进行的操作。这个数值被看作一个「通知码」。通知码的值由以SB（代表「scroll bar（滚动条）」）开头的标识符定义。以下是在WINUSER.H中定义的通知码：

#define SB_LINEUP       0
            
    #define SB_LINELEFT           0
            
    #define SB_LINEDOWN           1
            
    #define SB_LINERIGHT          1
            
    #define SB_PAGEUP         2
            
    #define SB_PAGELEFT           2
            
    #define SB_PAGEDOWN           3
            
    #define SB_PAGERIGHT          3
            
    #define SB_THUMBPOSITION   4
            
    #define SB_THUMBTRACK         5
            
    #define SB_TOP                6
            
    #define SB_LEFT           6
            
    #define SB_BOTTOM        7
            
    #define SB_RIGHT          7
            
    #define SB_ENDSCROLL          8

包含LEFT和RIGHT的标识符用于水平滚动条，包含UP、DOWN、TOP和BOTTOM的标识符用于垂直滚动条。鼠标在滚动条的不同区域单击所产生的通知码如图4-7所示。

![SouthEast][]

如果在滚动条的各个部位按住鼠标键，程序就能收到多个滚动条消息。当释放鼠标键后，程序会收到一个带有SB\_ENDSCROLL通知码的消息。一般可以忽略这个消息，Windows不会去改变卷动方块的位置，而您可以在程序中呼叫SetScrollPos来改变卷动方块的位置。

当把鼠标的光标放在卷动方块上并按住鼠标键时，您就可以移动卷动方块。这样就产生了带有SB\_THUMBTRACK和SB\_THUMBPOSITION通知码的滚动条消息。在wParam的低字组是SB\_THUMBTRACK时，wParam的高字组是使用者在拖动卷动方块时的目前位置。该位置位于卷动列范围的最小值和最大值之间。在wParam的低字组是SB\_THUMBPOSITION时，wParam的高字组是使用者释放鼠标键后卷动方块的最终位置。对于其它的卷动列操作，wParam的高字组应该被忽略。

为了给使用者提供回馈，Windows在您用鼠标拖动卷动方块时移动它，同时您的程序会收到SB\_THUMBTRACK消息。然而，如果不通过呼叫SetScrollPos来处理SB\_THUMBTRACK或SB\_THUMBPOSITION消息，在使用者释放鼠标键后，卷动方块会迅速跳回原来的位置。

程序能够处理SB\_THUMBTRACK或SB\_THUMBPOSITION消息，但一般不同时处理两者。如果处理SB\_THUMBTRACK消息，在使用者拖动卷动方块时您需要移动显示区域的内容。而如果处理SB\_THUMBPOSITION消息，则只需在使用者停止拖动卷动方块时移动显示区域的内容。处理SB\_THUMBTRACK消息更好一些（但更困难），对于某些型态的数据，您的程序可能很难跟上产生的消息。

WINUSER.H表头文件还包括SB\_TOP、SB\_BOTTOM、SB\_LEFT和SB\_RIGHT通知码，指出滚动条已经被移到了它的最小或最大位置。然而，对于作为应用程序窗口一部分而建立的滚动条来说，永远不会接收到这些通知码。

在滚动条范围使用32位的值也是有效的，尽管这不常见。然而，wParam的高字组只有16位的大小，它不能适当地指出SB\_THUMBTRACK和SB\_THUMBPOSITION操作的位置。在这种情况下，需要使用GetScrollInfo函数（在下面描述）来得到信息。

在SYSMETS中加入卷动功能

前面的说明已经很详尽了，现在，要将那些东西动手做做看了。让我们开始时简单些，从垂直卷动着手，因为我们实在太需要垂直卷动了，而暂时还可以不用水平卷动。SYSMET2如程序4-3所示。这个程序可能是滚动条的最简单的应用。

程序4-3 SYSMETS2.C

/*------------------------------------------------------------------
            
        SYSMETS2.C -- System Metrics Display Program No. 2
            
                (c) Charles Petzold, 1998
            
    ------------------------------------------------------------------*/
            
    #include <windows.h>
            
    #include "sysmets.h"
            
    LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM) ;
            
    int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
            
                     PSTR szCmdLine, int iCmdShow)
            
    {
            
        static TCHAR szAppName[] = TEXT ("SysMets2") ;
            
        HWND   hwnd ;
            
        MSG    msg ;
            
        WNDCLASS wndclass ;
            
        wndclass.style           = CS_HREDRAW | CS_VREDRAW ;
            
        wndclass.lpfnWndProc  = WndProc ;
            
        wndclass.cbClsExtra   = 0 ;
            
        wndclass.cbWndExtra   = 0 ;
            
        wndclass.hInstance       = hInstance ;
            
        wndclass.hIcon        = LoadIcon (NULL, IDI_APPLICATION) ;
            
        wndclass.hCursor         = LoadCursor (NULL, IDC_ARROW) ;
            
        wndclass.hbrBackground        = (HBRUSH) GetStockObject (WHITE_BRUSH) ;
            
        wndclass.lpszMenuName         = NULL ;
            
        wndclass.lpszClassName        = szAppName ;
            
    
        if (!RegisterClass (&wndclass))
            
        {
            
        MessageBox (NULL, TEXT ("This program requires Windows NT!"),
            
               szAppName, MB_ICONERROR) ;
            
        return 0 ;
            
        }
            
    
        hwnd = CreateWindow (szAppName, TEXT ("Get System Metrics No. 2"),
            
                       WS_OVERLAPPEDWINDOW | WS_VSCROLL,
            
                       CW_USEDEFAULT, CW_USEDEFAULT,
            
                       CW_USEDEFAULT, CW_USEDEFAULT,
            
                       NULL, NULL, hInstance, NULL) ;
            
        ShowWindow (hwnd, iCmdShow) ;
            
        UpdateWindow (hwnd) ;
            
    
        while (GetMessage (&msg, NULL, 0, 0))
            
        {
            
           TranslateMessage (&msg) ;
            
            DispatchMessage (&msg) ;
            
        }
            
        return msg.wParam ;
            
    }
            
    LRESULT CALLBACK WndProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
            
    {
            
        static int  cxChar, cxCaps, cyChar, cyClient, iVscrollPos ;
            
        HDC         hdc ;    
            
        int         i, y ;   
            
        PAINTSTRUCT ps ;
            
        TCHAR       szBuffer[10] ;   
            
        TEXTMETRIC  tm ;     
            
        switch (message)     
            
        {
            
    case WM_CREATE:
            
        hdc = GetDC (hwnd) ;
            
        GetTextMetrics (hdc, &tm) ;
            
        cxChar = tm.tmAveCharWidth ;
            
        cxCaps = (tm.tmPitchAndFamily & 1 ? 3 : 2) * cxChar / 2 ;
            
        cyChar = tm.tmHeight + tm.tmExternalLeading ;
            
    
        ReleaseDC (hwnd, hdc) ;
            
        SetScrollRange (hwnd, SB_VERT, 0, NUMLINES - 1, FALSE) ;
            
        SetScrollPos   (hwnd, SB_VERT, iVscrollPos, TRUE) ;
            
                return 0 ;
            
    
        case WM_SIZE:
            
                cyClient = HIWORD (lParam) ;
            
                return 0 ;
            
    
        case WM_VSCROLL:
            
                switch (LOWORD (wParam))
            
             {
            
        case SB_LINEUP:
            
              iVscrollPos -= 1 ;
            
                break ;
            
       
            
        case SB_LINEDOWN:
            
                iVscrollPos += 1 ;
            
                break ;
            
    
        case SB_PAGEUP:
            
                iVscrollPos -= cyClient / cyChar ;
            
                break ;
            
       
            
        case SB_PAGEDOWN:
            
                iVscrollPos += cyClient / cyChar ;
            
                break ;
            
       
            
        case SB_THUMBPOSITION:
            
                iVscrollPos = HIWORD (wParam) ;
            
                break ;
            
       
            
        default :
            
                break ;
            
             }
            
    
        iVscrollPos = max (0, min (iVscrollPos, NUMLINES - 1)) ;
            
        if (iVscrollPos != GetScrollPos (hwnd, SB_VERT))
            
             {
            
                SetScrollPos (hwnd, SB_VERT, iVscrollPos, TRUE) ;
            
                InvalidateRect (hwnd, NULL, TRUE) ;
            
             }
            
                return 0 ;
            
        case WM_PAINT:
            
                hdc = BeginPaint (hwnd, &ps) ;
            
                for (i = 0 ; i < NUMLINES ; i++)
            
                {
            
                       y = cyChar * (i - iVscrollPos) ;
            
                       TextOut (hdc, 0, y,
            
                               sysmetrics[i].szLabel,
            
                               lstrlen (sysmetrics[i].szLabel)) ;
            
       
            
                       TextOut (hdc, 22 * cxCaps, y,
            
                               sysmetrics[i].szDesc,
            
                               lstrlen (sysmetrics[i].szDesc)) ;
            
       
            
                       SetTextAlign (hdc, TA_RIGHT | TA_TOP) ;
            
                       TextOut (hdc, 22 * cxCaps + 40 * cxChar, y, szBuffer,
            
                               wsprintf (szBuffer, TEXT ("%5d"),
            
                                              GetSystemMetrics (sysmetrics[i].iIndex))) ;
            
                       SetTextAlign (hdc, TA_LEFT | TA_TOP) ;
            
            }
            
                EndPaint (hwnd, &ps) ;
            
                return 0 ;
            
    
        case WM_DESTROY:
            
                PostQuitMessage (0) ;
            
                return 0 ;
            
        }
            
        return DefWindowProc (hwnd, message, wParam, lParam) ;
            
    }

新的CreateWindow呼叫在第三个参数中包含了WS\_VSCROLL窗口样式，从而在窗口中加入了垂直滚动条，其窗口样式为：

WS\_OVERLAPPEDWINDOW | WS\_VSCROLL

WndProc窗口消息处理程序在处理WM\_CREATE消息时增加了两条叙述，以设置垂直滚动条的范围和初始位置：

SetScrollRange (hwnd, SB\_VERT, 0, NUMLINES - 1, FALSE) ;  
         
SetScrollPos (hwnd, SB\_VERT, iVscrollPos, TRUE) ;

sysmetrics结构具有NUMLINES行文字，所以滚动条范围被设定为0至NUMLINES-1。滚动条的每个位置对应于在显示区域顶部显示的一个文字行。如果卷动方块的位置为0，则第一行会被放置在显示区域的顶部。如果位置大于0，其它行就会出现在显示区域的顶部。当位置为NUMLINES-1时，则最后一行文字出现在显示区域的顶部。

为了有助于处理WM\_VSCROLL消息，在窗口消息处理程序中定义了一个静态变量iVscrollPos，这一变量是滚动条内卷动方块的目前位置。对于SB\_LINEUP和SB\_LINEDOWN，只需要将卷动方块调整一个单位的位置。对于SB\_PAGEUP和SB\_PAGEDOWN，我们想移动一整面的内容，或者移动cyClient /cyChar个单位的位置。对于SB\_THUMBPOSITION，新的卷动方块位置是wParam的高字组。SB\_ENDSCROLL和SB\_THUMBTRACK消息被忽略。

在程序依据收到的WM\_VSCROLL消息计算出新的iVscrollPos值后，用min和max宏来调整iVscrollPos，以确保它在最大值与最小值之间。程序然后将iVscrollPos与呼叫GetScrollPos取得的先前位置相比较，如果卷动位置发生了变化，则使用SetScrollPos来进行更新，并且呼叫InvalidateRect使整个窗口无效。

InvalidateRect呼叫产生一个WM\_PAINT消息。SYSMETS1在处理WM\_PAINT消息时，每一行的y坐标计算公式为：

cyChar \* i

在SYSMETS2中，计算公式为：

cyChar \* (i - iVscrollPos)

循环仍然显示NUMLINES行文字，但是对于非零值的iVscrollPos是负数。程序实际上在显示区域以外显示这些文字行。当然，Windows不会显示这些行，因此屏幕显得干净和漂亮。

前面说过，我们一开始不想弄得太复杂，这样的程序代码很浪费，效率很低。下面我们对此加以修改，但是先要考虑在WM\_VSCROLL消息之后更新显示区域的方法。

<br />本文来自【C语言中文网】：<a href="[http://see.xidian.edu.cn/cpp/html/1112.html][http_see.xidian.edu.cn_cpp_html_1112.html]" target="\_blank">http://see.xidian.edu.cn/cpp/html/1112.html</a>

[SouthEast]: /images/20221022/ef1e29738fcc4d12bd92396f08c176c0.png
[http_see.xidian.edu.cn_cpp_html_1112.html]: http://see.xidian.edu.cn/cpp/html/1112.html