《Windows程序設計》讀書筆記------------->>基本滾動條

一、滾動條的建立：
在CreateWindow的第三個參數中包括窗口樣式（WS）標識符WS_VSCROLL（垂直捲動）和/或WS_HSCROLL（水平捲動）即可。

二、需要做的：

Windows對滾動條的處理：

處理所有滾動條鼠標事件
　
當使用者在滾動條內單擊鼠標時，提供一種「反相顯示」的閃爍
　
當使用者在滾動條內拖動捲動方塊時，移動捲動方塊
　
爲包含滾動條窗口的窗口消息處理程序發送滾動條消息

程序寫作者應該完成的工作：

初始化滾動條的範圍和位置

1、範圍

SetScrollRange (hwnd, iBar, iMin, iMax, bRedraw) ;

參數iBar爲SB_VERT或者SB_HORZ，iMin和iMax分別是範圍的最小值和最大值。如果想要Windows根據新範圍重畫滾動條，則設置bRedraw爲TRUE（如果在呼叫SetScrollRange後，呼叫了影響滾動條位置的其它函數，則應該將bRedraw設定爲FALSE以避免過多的重畫）。
一般情況下，最小值和最大值應該是與文本緊密關聯的內容，以方便操作。

2、位置

SetScrollPos (hwnd, iBar, iPos, bRedraw) ;

參數iPos是新位置，它必須在iMin至iMax的範圍內。Windows提供了類似的函數（GetScrollRange和GetScrollPos）來取得滾動條的目前範圍和位置。
　

處理窗口消息處理程序的滾動條消息

在用鼠標單擊滾動條或者拖動捲動方塊時，Windows給窗口消息處理程序發送WM_VSCROLL（供上下移動）和WM_HSCROLL（供左右移動）消息。在滾動條上的每個鼠標動作都至少產生兩個消息，一條在按下鼠標按鈕時產生，一條在釋放按鈕時產生。

和所有的消息一樣，WM_VSCROLL和WM_HSCROLL也帶有wParam和lParam消息參數。wParam消息參數被分爲一個低字組和一個高字組。wParam的低字組是一個數值，它指出了鼠標對滾動條進行的操作。

這些操作有：

#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

在wParam的低字組是SB_THUMBTRACK時，wParam的高字組是使用者在拖動捲動方塊時的目前位置。

PS:取得低字組的方法是使用LOWORD(wParam),取得高字組的方法是使用HIWORD(wParam)。

更新滾動條內捲動方塊的位置

Windows不會去改變捲動方塊的位置，而您可以在程序中呼叫SetScrollPos來改變捲動方塊的位置。
　

更改顯示區域的內容以響應對滾動條的更改（看註釋）

/**//*------------------------------------------------------------------

    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)) ;//非常精彩的宏！控制了iVscrollPos不會超過ScrollRange

    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) ;//iVscrollPos中記錄了偏移的大小，所以y需要重新計算

                   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) ;

}