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. 編譯運行程序,彈出結果對話框,可以自己拖動滾動塊看是否能正常滾動,並且編輯框中也顯示了正確的數值。效果如下:
至於垂直滾動條,其實與水平滾動條類似,大家可以自己寫寫垂直滾動條的例子。滾動條控件的內容就講到這裏了,比較基礎,但這些是以後應用滾動條控件的必知內容。
VS2010-MFC(常用控件:滾動條控件Scroll Bar)