Windows API学习之滚动条系列函数

最新推荐文章于 2019-08-07 09:03:01 发布

原创最新推荐文章于 2019-08-07 09:03:01 发布 · 9.6k 阅读

26 ·

CC 4.0 BY-SA版权

文章标签：

#windows #api #scroll #null #less

Visual C++ 专栏收录该内容

204 篇文章

订阅专栏

本文详细介绍了Windows API中关于滚动条的两个核心函数SetScrollInfo和GetScrollInfo的使用方法及参数含义，并提供了实例代码来展示如何设置和获取滚动条的各种信息。

作者：朱金灿
来源：http://blog.youkuaiyun.com/clever101

Windows API中滚动条相关函数有两个：
int SetScrollInfo(
HWND hwnd,
int fnBar,
LPSCROLLINFO lpsi,
BOOL fRedraw
);

BOOL GetScrollInfo(
HWND hwnd,
int fnBar,
LPSCROLLINFO lpsi
);

见名知意，SetScrollInfo就是用来设置窗口的滚动信息，GetScrollInfo就是用来获取窗口的滚动信息。SetScrollInfo的参数含义如下：
参数意义
hwnd
滚动条控件的句柄或带有标准滚动栏的窗口的句柄
fnBar
用于指定哪一种滚动条，只能是下面的值之一：
SB_CTL ：滚动条控件
SB_HORZ：水平滚动条
SB_VERT：垂直滚动条
lpsi
滚动条信息结构体指针。下面作进一步详细介绍。
fRedraw 值为TRUE表示要Windows重新绘制计算了新信息后的滚动条，FALSE表示不绘制。

GetScrollInfo的参数含义如下：

参数意义
hwnd
滚动条控件的句柄或带有标准滚动栏的窗口的句柄
fnBar
用于指定哪一种滚动条，只能是下面的值之一：
SB_CTL ：滚动条控件
SB_HORZ：水平滚动条
SB_VERT：垂直滚动条
lpsi
滚动条信息结构体指针。下面作进一步详细介绍。

值得注意的是在调用GetScrollInfo函数时要获取相关滚动信息，需要指定SCROLLINFO结构体中的fMask成员的值。fMask取下面的值的组合值：
值意义
SIF_PAGE 获取SCROLLINFO中的nPage成员的值（即一页的大小）。
SIF_POS 获取SCROLLINFO中的nPos成员的值。
SIF_RANGE
获取SCROLLINFO中的nPos成员的nMin 和 nMax的值。
SIF_TRACKPOS
获取SCROLLINFO中的nTrackPos成员的值。
nTrackPos
SIF_RANGE、SIF_POS、SIF_PAGE和SIF_TRACKPOS的组合。

使用例程（据petzod的《windows程序设计》第四章，仅列出主要代码片段，具体请下载源码）：

case WM_SIZE: { // save the width and height of window when changed the size of window cxClient = LOWORD(lp); // the width cyClient = HIWORD(lp); // the height // set vertical scroll bar range and page size si.cbSize = sizeof(SCROLLBARINFO); si.fMask = SIF_RANGE|SIF_PAGE; si.nMin = 0; si.nMax = NUMLINES - 1; si.nPage = cyClient/cyChar; SetScrollInfo(hWnd,SB_VERT,&si,TRUE); // set horizontal scroll bar and page size si.cbSize = sizeof(SCROLLBARINFO); si.fMask = SIF_RANGE|SIF_PAGE; si.nMin = 0; si.nMax = 2 + nMaxWidth/cxChar; si.nPage = cxClient/cxChar; SetScrollInfo(hWnd,SB_HORZ,&si,TRUE); return 0; } case WM_VSCROLL: { // get all vertical scroll bar information si.cbSize = sizeof(SCROLLINFO); si.fMask = SIF_ALL; ::GetScrollInfo(hWnd,SB_VERT,&si); // save the position for comparison later on nVertPos = si.nPos; switch (LOWORD(wp)) { case SB_LINEUP: { si.nPos -=1;// the height decrease 1 unit break; } case SB_LINEDOWN: { si.nPos +=1;// the height increase 1 unit break; } case SB_PAGEUP: { // back to prev page, the cyClient/cyChar is the number of row in one page si.nPos -= cyClient/cyChar; break; } case SB_PAGEDOWN: { // back to next page si.nPos += cyClient/cyChar; break; } case SB_THUMBPOSITION: { si.nPos = HIWORD(wp); break; } default: break; } // set the position and then retrieve it.Due to adjustments // by Windows it may not be the same as the value set. si.fMask = SIF_POS; SetScrollInfo(hWnd,SB_VERT,&si,TRUE); GetScrollInfo(hWnd,SB_VERT,&si); //if the position has changed,scroll the window update it if (si.nPos!=nVertPos) { ::ScrollWindow(hWnd,0,cyChar*(nVertPos-si.nPos),NULL,NULL); ::UpdateWindow(hWnd); } return 0; } case WM_HSCROLL: { // get all the vertical scroll bar information si.cbSize = sizeof(si); si.fMask = SIF_ALL; // save the position for comparison later on ::GetScrollInfo(hWnd,SB_HORZ,&si); nHorzPos = si.nPos; switch (LOWORD(wp)) { case SB_LINELEFT: { si.nPos -=1; break; } case SB_LINERIGHT: { si.nPos +=1; break; } case SB_PAGELEFT: { si.nPos -= si.nPage; break; } case SB_PAGERIGHT: { si.nPos += si.nPage; break; } case SB_THUMBPOSITION: { si.nPos = si.nTrackPos; break; } default: break; } // set the position and then retrieve it.due to adjustments // by windows it may not be the same as the value set si.fMask = SIF_POS; ::SetScrollInfo(hWnd,SB_HORZ,&si,TRUE); ::GetScrollInfo(hWnd,SB_HORZ,&si); // if the postion has changed ,scroll the window if (si.nPos!=nHorzPos) { ::ScrollWindow(hWnd,cxChar*(nHorzPos-si.nPos),0,NULL,NULL); } return 0; } case WM_PAINT: { hdc = ::BeginPaint(hWnd,&ps); // get vertical scroll bar position si.cbSize = sizeof(si); si.fMask = SIF_POS; ::GetScrollInfo(hWnd,SB_VERT,&si); nVertPos = si.nPos; // get horizontal scroll bar position GetScrollInfo(hWnd,SB_HORZ,&si); nHorzPos = si.nPos; // find painting limits int nPaintBeg = max(0,nVertPos+ps.rcPaint.top/cyChar); // the begin row int nPaintEnd = min(NUMLINES-1,nVertPos+ps.rcPaint.bottom/cyChar); // the end row for (int i =nPaintBeg;i<=nPaintEnd;i++) { // calculate the y position of draw region, when y position less 0,skip int x = cxChar*(1-nHorzPos); int y = cyChar*(i-nVertPos); ::TextOut(hdc,x,y,sysmetrics[i].szLabel,lstrlen(sysmetrics[i].szLabel)); ::TextOut(hdc,x+22*cxCaps,y,sysmetrics[i].szDesc,lstrlen(sysmetrics[i].szDesc)); ::SetTextAlign(hdc,TA_RIGHT|TA_TOP); ::TextOut(hdc,x+22*cxCaps+40*cxChar,y,szBuffer,wsprintf(szBuffer,_T("%5d"),::GetSystemMetrics(sysmetrics[i].Index))); ::SetTextAlign(hdc,TA_LEFT|TA_TOP); } ::EndPaint(hWnd,&ps); return 0; }