SetScrollInfo功能设置滚动条的参数,包括最小和最大滚动位置,页面大小和滚动框(拇指)的位置。如果需要,该函数也会重绘滚动条。
int SetScrollInfo(
HWND【HWND】, | //用滚动条来处理窗口 |
INT【fnBar】, | //滚动条标志 |
LPSCROLLINFO【lpsi】, | //指向带有滚动参数的结构的指针 |
BOOL【fRedraw】 | //重绘旗帜 |
); |
参数
【HWND】
根据【fnBar】参数的值,标识滚动条控件或具有标准滚动条的窗口。
【fnBar】
指定要设置参数的滚动条的类型。此参数可以是以下值之一:
值 | 含义 |
SB_CTL | 设置滚动条控件的参数。【HWND】参数必须是滚动条控件的句柄。 |
SB_HORZ | 设置给定窗口的标准水平滚动条的参数。 |
SB_VERT | 设置给定窗口的标准垂直滚动条的参数。 |
【lpsi】
指向fMask结构的fMask成员,在进入该函数时,指定要设置的滚动条参数。
fMask成员可以是以下值的组合:
值 | 含义 |
SIF_DISABLENOSCROLL | 禁用滚动条,而不是删除它,如果滚动条的新参数使滚动条不必要。 |
SIF_PAGE | 将滚动页面设置为由【lpsi】指向的SCROLLINFO结构的SCROLLINFO成员中指定的值。 |
SIF_POS | 将滚动位置设置为由【lpsi】指向的SCROLLINFO结构的SCROLLINFO成员中指定的值。 |
SIF_RANGE | 将滚动范围设置为由【lpsi】指向的SCROLLINFO结构SCROLLINFO结构的nMin nMax成员中指定的值。 |
【fRedraw】
指定是否重新绘制滚动条以反映滚动条的更改。如果此参数为TRUE,则重绘滚动条,否则不重绘。
返回值
返回值是滚动框的当前位置。
备注
SetScrollInfo功能对SCROLLINFO结构的nPage成员和nPos成员指定的值执行范围检查。nPage成员必须指定从0到nMax - nMin +1的值。nPos成员必须指定nMax和nMax - 最大(nPage - 1,0)之间的值。如果任一值超出其范围,该函数将其设置为仅在该范围内的值。
也可以看看