卷动列的范围和位置
每个卷动列均有一个相关的「范围」（这是一对整数，分别代表最小值和最大值）和「位置」（它是卷动方块在此范围内的位置）。当卷动方块在卷动列的顶部（或左部）时，卷动方块的位置是范围的最小值；在卷动列的底部（或右部）时，卷动方块的位置是范围的最大值。
在内定情况下，卷动列的范围是从0（顶部或左部）至100（底部或右部），但将范围改变为更方便於程式的数值也是很容易的：
SetScrollRange (hwnd, iBar, iMin, iMax, bRedraw) ;
参数iBar为SB_VERT或者SB_HORZ，iMin和iMax分别是范围的最小值和最大值。如果想要Windows根据新范围重画卷动列，则设置bRedraw为TRUE（如果在呼叫SetScrollRange後，呼叫了影响卷动列位置的其他函式，则应该将bRedraw设定为FALSE以避免过多的重画）。
卷动方块的位置总是离散的整数值。例如，范围为0至4的卷动列具有5个卷动方块位置，如图4-6所示。
| 图4-6 具有5个卷动方块位置的卷动列 |
您可以使用SetScrollPos在卷动列范围内设置新的卷动方块位置：
SetScrollPos (hwnd, iBar, iPos, bRedraw) ;
参数iPos是新位置，它必须在iMin至iMax的范围内。Windows提供了类似的函式（GetScrollRange和GetScrollPos）来取得卷动列的目前范围和位置。
在程式内使用卷动列时，程式写作者与Windows共同负责维护卷动列以及更新卷动方块的位置。下面是Windows对卷动列的处理：
- 处理所有卷动列滑鼠事件
- 当使用者在卷动列内单击滑鼠时，提供一种「反相显示」的闪烁
- 当使用者在卷动列内拖动卷动方块时，移动卷动方块
- 为包含卷动列视窗的视窗讯息处理程式发送卷动列讯息
以下是程式写作者应该完成的工作：
- 初始化卷动列的范围和位置
- 处理视窗讯息处理程式的卷动列讯息
- 更新卷动列内卷动方块的位置
- 更改显示区域的内容以回应对卷动列的更改
像生活中的大多数事情一样，在我们看一些程式码时这些会显得更加有意义。
卷动列讯息
在用滑鼠单击卷动列或者拖动卷动方块时，Windows给视窗讯息处理程式发送WM_VSCROLL（供上下移动）和WM_HSCROLL（供左右移动）讯息。在卷动列上的每个滑鼠动作都至少产生两个讯息，一条在按下滑鼠按钮时产生，一条在释放按钮时产生。
和所有的讯息一样， WM_VSCROLL和WM_HSCROLL也带有wParam和lParam讯息参数。对於来自作为视窗的一部分而建立的卷动列讯息，您可以忽略lParam；它只用于作为子视窗而建立的卷动列（通常在对话方块内）。
wParam讯息参数被分为一个低字组和一个高字组。wParam的低字组是一个数值，它指出了滑鼠对卷动列进行的操作。这个数值被看作一个「通知码」。通知码的值由以SB（代表「scroll bar（卷动列）」）开头的识别字定义。以下是在WINUSER.H中定义的通知码：
#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
包含LEFT和RIGHT的识别字用於水平卷动列，包含UP、DOWN、TOP和BOTTOM的识别字用於垂直卷动列。滑鼠在卷动列的不同区域单击所产生的通知码如图4-7所示。
| 图4-7 用於卷动列讯息的wParam值的识别字 |
如果在卷动列的各个部位按住滑鼠键，程式就能收到多个卷动列讯息。当释放滑鼠键後，程式会收到一个带有SB_ENDSCROLL通知码的讯息。一般可以忽略这个讯息，Windows不会去改变卷动方块的位置，而您可以在程式中呼叫SetScrollPos来改变卷动方块的位置。
当把滑鼠的游标放在卷动方块上并按住滑鼠键时，您就可以移动卷动方块。这样就产生了带有SB_THUMBTRACK和SB_THUMBPOSITION通知码的卷动列讯息。在wParam的低字组是SB_THUMBTRACK时，wParam的高字组是使用者在拖动卷动方块时的目前位置。该位置位於卷动列范围的最小值和最大值之间。在wParam的低字组是SB_THUMBPOSITION时，wParam的高字组是使用者释放滑鼠键後卷动方块的最终位置。对於其他的卷动列操作，wParam的高字组应该被忽略。
为了给使用者提供回馈，Windows在您用滑鼠拖动卷动方块时移动它，同时您的程式会收到SB_THUMBTRACK讯息。然而，如果不通过呼叫SetScrollPos来处理SB_THUMBTRACK或SB_THUMBPOSITION讯息，在使用者释放滑鼠键後，卷动方块会迅速跳回原来的位置。
程式能够处理SB_THUMBTRACK或SB_THUMBPOSITION讯息，但一般不同时处理两者。如果处理SB_THUMBTRACK讯息，在使用者拖动卷动方块时您需要移动显示区域的内容。而如果处理SB_THUMBPOSITION讯息，则只需在使用者停止拖动卷动方块时移动显示区域的内容。处理SB_THUMBTRACK讯息更好一些（但更困难），对於某些型态的资料，您的程式可能很难跟上产生的讯息。
WINUSER.H表头档案还包括SB_TOP、SB_BOTTOM、SB_LEFT和SB_RIGHT通知码，指出卷动列已经被移到了它的最小或最大位置。然而，对於作为应用程式视窗一部分而建立的卷动列来说，永远不会接收到这些通知码。
在卷动列范围使用32位元的值也是有效的，尽管这不常见。然而，wParam的高字组只有16位元的大小，它不能适当地指出SB_THUMBTRACK和SB_THUMBPOSITION操作的位置。在这种情况下，需要使用GetScrollInfo函式（在下面描述）来得到资讯。
在SYSMETS中加入卷动功能
前面的说明已经很详尽了，现在，要将那些东西动手做做看了。让我们开始时简单些，从垂直卷动著手，因为我们实在太需要垂直卷动了，而暂时还可以不用水平卷动。SYSMET2如程式4-3所示。这个程式可能是卷动列的最简单的应用。
程式4-3 SYSMETS2.C
/*------------------------------------------------------------------
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)) ;
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) ;
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) ;
}
新的CreateWindow呼叫在第三个参数中包含了WS_VSCROLL视窗样式，从而在视窗中加入了垂直卷动列，其视窗样式为：
WS_OVERLAPPEDWINDOW | WS_VSCROLL
WndProc视窗讯息处理程式在处理WM_CREATE讯息时增加了两条叙述，以设置垂直卷动列的范围和初始位置：
SetScrollRange (hwnd, SB_VERT, 0, NUMLINES - 1, FALSE) ; SetScrollPos (hwnd, SB_VERT, iVscrollPos, TRUE) ;
sysmetrics结构具有NUMLINES行文字，所以卷动列范围被设定为0至NUMLINES-1。卷动列的每个位置对应于在显示区域顶部显示的一个文字行。如果卷动方块的位置为0，则第一行会被放置在显示区域的顶部。如果位置大於0，其他行就会出现在显示区域的顶部。当位置为NUMLINES-1时，则最後一行文字出现在显示区域的顶部。
为了有助於处理WM_VSCROLL讯息，在视窗讯息处理程式中定义了一个静态变数iVscrollPos，这一变数是卷动列内卷动方块的目前位置。对於SB_LINEUP和SB_LINEDOWN，只需要将卷动方块调整一个单位的位置。对於SB_PAGEUP和SB_PAGEDOWN，我们想移动一整面的内容，或者移动cyClient /cyChar个单位的位置。对於SB_THUMBPOSITION，新的卷动方块位置是wParam的高字组。SB_ENDSCROLL和SB_THUMBTRACK讯息被忽略。
在程式依据收到的WM_VSCROLL讯息计算出新的iVscrollPos值後，用min和max巨集来调整iVscrollPos，以确保它在最大值与最小值之间。程式然後将iVscrollPos与呼叫GetScrollPos取得的先前位置相比较，如果卷动位置发生了变化，则使用SetScrollPos来进行更新，并且呼叫InvalidateRect使整个视窗无效。
InvalidateRect呼叫产生一个WM_PAINT讯息。SYSMETS1在处理WM_PAINT讯息时，每一行的y座标计算公式为：
cyChar * i
在SYSMETS2中，计算公式为：
cyChar * (i - iVscrollPos)
回圈仍然显示NUMLINES行文字，但是对於非零值的iVscrollPos是负数。程式实际上在显示区域以外显示这些文字行。当然，Windows不会显示这些行，因此萤幕显得乾净和漂亮。
前面说过，我们一开始不想弄得太复杂，这样的程式码很浪费，效率很低。下面我们对此加以修改，但是先要考虑在WM_VSCROLL讯息之後更新显示区域的方法。
扫一扫
960
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
