VS2010-MFC（常用控件：滾動條控件Scroll Bar）

 

轉自：http://www.jizhuomi.com/software/191.html

 

 

       滾動條控件簡介

       滾動條大家也很熟悉了，Windows窗口中很多都有滾動條。前面講的列表框和組合框設置了相應屬性后，如果列表項顯示不下也會出現滾動條。滾動條分為水平滾動條（Horizontal Scroll Bar）和垂直滾動條（Vertical Scroll Bar）兩種。滾動條中有一個滾動塊，用於標識滾動條當前滾動的位置。我們可以拖動滾動塊，也可以用鼠標點擊滾動條某一位置使滾動塊移動。

       從滾動條的創建形式來分，有標准滾動條和滾動條控件兩種。像列表框和組合框設置了WS_HSCROLL 或WS_VSCROLL風格以后出現的滾動條，不是一個獨立的窗口，而是這些窗口的一部分，這就是標准滾動條。而滾動條控件是一個獨立的窗口，它可以獲得焦點，響應某些操作。

 

       滾動條控件的創建

       MFC也為滾動條控件的操作提供了類，即為CScrollBar類。

       滾動條控件的創建依然有兩種方式，一種是直接在Toolbox中將滾動條控件拖入對話框模板，然后添加控件變量使用，另一種就是用CScrollBar類的Create成員函數動態創建。這兩種方式適用於不同的場合。

       CScrollBar類的成員函數Create的函數原型如下：

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

       此函數與其他控件類的Create函數原型基本相同。參數dwStyle指定滾動條控件的風格，rect指定滾動條控件的位置和尺寸，pParentWnd為指向滾動條控件父窗口的指針，nID指定滾動條控件的ID。下面簡單介紹幾個主要的滾動條控件風格，更加具體的可以查閱MSDN。

       SBS_HORZ：指定滾動條為水平滾動條。如果沒有指定SBS_BOTTOMALIGN或SBS_TOPALIGN風格，則滾動條的高度、寬度和位置由Create函數的rect參數給出。
       SBS_VERT：指定滾動條為垂直滾動條。如果沒有指定SBS_RIGHTALIGN或SBS_LEFTALIGN風格，則滾動條的高度、寬度和位置由Create函數的rect參數給出。
       SBS_TOPALIGN：與SBS_HORZ配合使用。滾動條的上邊緣與Create函數的rect參數指定矩形的上邊緣對齊。滾動條高度為系統滾動條的默認高度。
       SBS_BOTTOMALIGN：與SBS_HORZ配合使用。滾動條的下邊緣與Create函數的rect參數指定矩形的下邊緣對齊。滾動條高度為系統滾動條的默認高度。
       SBS_LEFTALIGN：與SBS_VERT配合使用。滾動條的左邊緣與Create函數的rect參數指定矩形的左邊緣對齊。滾動條寬度為系統滾動條的默認寬度。
       SBS_RIGHTALIGN：與SBS_VERT配合使用。滾動條的右邊緣與Create函數的rect參數指定矩形的右邊緣對齊。滾動條寬度為系統滾動條的默認寬度。

       dwStyle參數可以是以上風格中某幾個的組合，另外一般也會用到WS_CHILD、WS_VISIBLE風格。例如，創建一個水平滾動條控件，dwStyle參數應該為WS_CHILD|WS_VISIBLE|SBS_HORZ，創建垂直滾動條控件時dwStyle參數應該為WS_CHILD|WS_VISIBLE|SBS_VERT。

 

 

       CScrollBar類的主要成員函數：

       BOOL GetScrollInfo(LPSCROLLINFO lpScrollInfo, UINT nMask = SIF_ALL);

       獲取的滾動條的參數信息，該信息為SCROLLINFO結構體的形式。參數lpScrollInfo為指向SCROLLINFO結構體變量的指針。SCROLLINFO結構體的定義如下：

C++代碼

typedef struct tagSCROLLINFO { UINT cbSize; // 結構的尺寸（字節為單位） 
    UINT fMask;          // 說明結構中的哪些參數是有效的，可以是屏蔽值的組合,如SIF_POS|SIF_PAGE，若為SIF_ALL則整個結構都有效 
    int  nMin;           // 滾動范圍最小值，當fMask 中包含SIF_RANGE 時有效 
    int  nMax;           // 滾動范圍最大值，當fMask 中包含SIF_RANGE 時有效 
    UINT nPage;          // 頁尺寸，用來確定比例滾動框的大小，當fMask中包含SIF_PAGE時有效 
    int  nPos;           // 滾動框的位置，當fMask 中包含SIF_POS 有效 
    int  nTrackPos;      // 滾動時滾動框的位置，當fMask 中包含SIF_TRACKPOS 時有效，該參數只能查詢，不能設置，最好不要用該參數來查詢拖動時滾動框的位置 
}   SCROLLINFO, *LPSCROLLINFO; typedef SCROLLINFO CONST *LPCSCROLLINFO;  

       參數nMask 的含義與SCROLLINFO 結構體中的fMask一樣。該函數在獲取信息成功則返回TRUE，否則返回FALSE。

 

 

       BOOL SetScrollInfo(LPSCROLLINFO lpScrollInfo, BOOL bRedraw = TRUE);

       用於設置滾動條的各種參數信息。參數lpScrollInfo為指向SCROLLINFO結構體變量的指針，參數bRedraw表示是否需要重繪滾動條，如果為TRUE，則重繪。該函數操作成功則返回TRUE，否則返回FALSE。

 

 

       int GetScrollPos( ) const;

       獲取滾動塊的當前位置。如果失敗則返回0。

 

       int SetScrollPos(int nPos, BOOL bRedraw = TRUE);

       將滾動塊移動到指定位置。參數nPos指定了滾動塊的新位置，參數bRedraw 表示是否需要重繪滾動條，如果為TRUE，則重繪。函數返回滾動框原來的位置，若操作失敗則返回0。

 

       void GetScrollRange(LPINT lpMinPos, LPINT lpMaxPos) const;

       獲取滾動條的滾動范圍。參數lpMinPos指向滾動條滾動范圍的最小值，參數lpMaxPos指向滾動條滾動范圍的最大值。

 

       void SetScrollRange(int nMinPos, int nMaxPos, BOOL bRedraw = TRUE);

       用於指定滾動條的滾動范圍。參數nMinPos 和nMaxPos 分別指定了滾動范圍的最小值和最大值，兩者的差不得超過32767。當兩者都為0 時，滾動條將被隱藏。參數bRedraw 表示是否需要重繪滾動條，如果為TRUE，則重繪。

 

       OnHScroll()與OnVScroll()函數

       無論是標准滾動條，還是滾動條控件，滾動條的通知消息都是用WM_HSCROLL 和WM_VSCROLL消息發送出去的。對這兩個消息的默認處理函數是CWnd::OnHScroll和CWnd::OnVScroll，一般需要在派生類中對這兩個函數進行重載，以實現滾動功能。也就是說，假設在一個對話框中放入了一個水平滾動條，我們可以在對話框類中重載OnHScroll函數，並在OnHScroll函數中實現滾動功能。

       這兩個函數的聲明如下：

       afx_msg void OnHScroll(UINT nSBCode,UINT nPos,CScrollBar* pScrollBar);
       afx_msg void OnVScroll(UINT nSBCode,UINT nPos,CScrollBar* pScrollBar);

       參數nSBCode是通知消息碼，主要通知碼及含義的介紹下面已列出。nPos 是滾動框的位置，只有在nSBCode為SB_THUMBPOSITION或SB_THUMBTRACK時，該參數才有意義。如果通知消息是滾動條控件發來的，那么pScrollBar 是指向該控件的指針，如果是標准滾動條發來的，則pScrollBar 為NULL。

 

       SB_BOTTOM/SB_RIGHT：滾動到底端（右端）
       SB_TOP/SB_LEFT：滾動到頂端（左端）
       SB_LINEDOWN/SB_LINERIGHT：向下（向右）滾動一行（列）
       SB_LINEUP/SB_LINELEFT：向上（向左）滾動一行（列）
       SB_PAGEDOWN/SB_PAGERIGHT：向下（向右）滾動一頁
       SB_PAGEUP/SB_PAGELEFT：向上（向左）滾動一頁
       SB_THUMBPOSITION：滾動到指定位置
       SB_THUMBTRACK：滾動框被拖動。可利用該消息來跟蹤對滾動框的拖動
       SB_ENDSCROLL：滾動結束

 

 

 

       CScrollBar類應用實例

       講完了基礎知識再給大家一個簡單的實例。例子非常簡單，就是在一個對話框中加入一個水平滾動條控件和一個編輯框控件，無論滾動條控件是在滾動還是靜止，編輯框中都顯示滾動塊的當前位置。以下是具體開發步驟：

       1. 創建一個基於對話框的MFC工程，名稱設置為“Example26”。

       2. 在自動生成的對話框模板IDD_EXAMPLE26_DIALOG中，刪除“TODO: Place dialog controls here.”靜態文本控件、“OK”按鈕和“Cancel”按鈕。添加一個Horizontal Scroll Bar控件，ID設置為IDC_HORI_SCROLLBAR。再添加一個靜態文本控件和一個編輯框，靜態文本控件的Caption屬性設為“滾動塊當前位置：”，編輯框的ID設為IDC_HSCROLL_EDIT，Read Only屬性設為True。此時的對話框模板如下圖：

      
       3. 為滾動條IDC_HORI_SCROLLBAR添加CScrollBar類型的控件變量m_horiScrollbar。

       4. 在對話框初始化時，我們需要設置滾動條的滾動范圍和初始位置，並在編輯框中顯示初始位置，那么需要修改CExample26Dlg::OnInitDialog()函數為：

C++代碼

BOOL CExample26Dlg::OnInitDialog() { CDialogEx::OnInitDialog(); // Add "About..." menu item to system menu. // IDM_ABOUTBOX must be in the system command range. 
    ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX); ASSERT(IDM_ABOUTBOX < 0xF000); CMenu* pSysMenu = GetSystemMenu(FALSE); if (pSysMenu != NULL) { BOOL bNameValid; CString strAboutMenu; bNameValid = strAboutMenu.LoadString(IDS_ABOUTBOX); ASSERT(bNameValid); if (!strAboutMenu.IsEmpty()) { pSysMenu->AppendMenu(MF_SEPARATOR); pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu); } } // Set the icon for this dialog. The framework does this automatically // when the application's main window is not a dialog 
    SetIcon(m_hIcon, TRUE);         // Set big icon 
    SetIcon(m_hIcon, FALSE);        // Set small icon // TODO: Add extra initialization here // 設置水平滾動條的滾動范圍為1到100 
    m_horiScrollbar.SetScrollRange(1, 100); // 設置水平滾動條的初始位置為20 
    m_horiScrollbar.SetScrollPos(20); // 在編輯框中顯示20 
    SetDlgItemInt(IDC_HSCROLL_EDIT, 20); return TRUE;  // return TRUE unless you set the focus to a control 
}  

 

 

       5. 現在滾動條還不能正常滾動，並且編輯框中數字也不隨滾動改變。根據上面所講，我們可以重載CExample26Dlg類的OnHScroll函數。具體操作為，在CExample26Dlg類的屬性頁面的工具欄上點“Messages”按鈕，找到WM_HSCROLL消息，添加響應函數就可以了。

 

OnHScroll函數重寫后如下：

void CExample26Dlg::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar) { // TODO: Add your message handler code here and/or call default 
    int pos = m_horiScrollbar.GetScrollPos();    // 獲取水平滾動條當前位置 
  
    switch (nSBCode) { // 如果向左滾動一列，則pos減1 
        case SB_LINELEFT: pos -= 1; break; // 如果向右滾動一列，則pos加1 
        case SB_LINERIGHT: pos += 1; break; // 如果向左滾動一頁，則pos減10 
        case SB_PAGELEFT: pos -= 10; break; // 如果向右滾動一頁，則pos加10 
        case SB_PAGERIGHT: pos += 10; break; // 如果滾動到最左端，則pos為1 
        case SB_LEFT: pos = 1; break; // 如果滾動到最右端，則pos為100 
        case SB_RIGHT: pos = 100; break; // 如果拖動滾動塊滾動到指定位置，則pos賦值為nPos的值 
        case SB_THUMBPOSITION: pos = nPos; break; // 下面的m_horiScrollbar.SetScrollPos(pos);執行時會第二次進入此函數，最終確定滾動塊位置，並且會直接到default分支，所以在此處設置編輯框中顯示數值 
        default: SetDlgItemInt(IDC_HSCROLL_EDIT, pos); return; } // 設置滾動塊位置 
 m_horiScrollbar.SetScrollPos(pos); CDialogEx::OnHScroll(nSBCode, nPos, pScrollBar); }

 

 

       6. 編譯運行程序，彈出結果對話框，可以自己拖動滾動塊看是否能正常滾動，並且編輯框中也顯示了正確的數值。效果如下：

 

 

 

        至於垂直滾動條，其實與水平滾動條類似，大家可以自己寫寫垂直滾動條的例子。滾動條控件的內容就講到這里了，比較基礎，但這些是以后應用滾動條控件的必知內容。

 

 

PS：關於OnHScroll函數重寫的幾個疑問。

1、注釋掉while循環中部分代碼，程序運行沒有影響。

 

void CExample26Dlg::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar) { // TODO: Add your message handler code here and/or call default 
    int pos = m_horiScrollbar.GetScrollPos();    // 獲取水平滾動條當前位置 
  
    switch (nSBCode) { // 如果向左滾動一列，則pos減1 
        case SB_LINELEFT: pos -= 1; break; // 如果向右滾動一列，則pos加1 
        case SB_LINERIGHT: pos += 1; break; // 如果向左滾動一頁，則pos減10 
       /* case SB_PAGELEFT: pos -= 10; break; // 如果向右滾動一頁，則pos加10 case SB_PAGERIGHT: pos += 10; break; // 如果滾動到最左端，則pos為1 case SB_LEFT: pos = 1; break; // 如果滾動到最右端，則pos為100 case SB_RIGHT: pos = 100; break; */
        // 如果拖動滾動塊滾動到指定位置，則pos賦值為nPos的值 
        case SB_THUMBPOSITION: pos = nPos; break; // 下面的m_horiScrollbar.SetScrollPos(pos);執行時會第二次進入此函數，最終確定滾動塊位置，並且會直接到default分支，所以在此處設置編輯框中顯示數值 
        default: SetDlgItemInt(IDC_HSCROLL_EDIT, pos); return; } // 設置滾動塊位置 
 m_horiScrollbar.SetScrollPos(pos); CDialogEx::OnHScroll(nSBCode, nPos, pScrollBar); }

 

 

2、關於default的注釋應該寫錯了，改成：

//最下面的CDialogEx::OnHScroll(nSBCode, nPos, pScrollBar);執行時會第二次進入此函數，最終確定滾動塊位置，並且會直接到default分支，所以在此處設置編輯框中顯示數值

 

 

如果把 SetDlgItemInt(IDC_HSCROLL_EDIT, pos); 語句拿出來（剪切）放到 m_horiScrollbar.SetScrollPos(pos);  下面，其余代碼不變，則程序運行無影響。