相关函数预览:
BOOL SetScrollRange(HWND hWnd, int nBar, int nMinPos, int nMaxPos, BOOL bRedraw);
int SetScrollPos(HWND hWnd, int nBar, int nPos, BOOL bRedraw);
int SetScrollInfo(HWND hWnd, int nBar, LPCSCROLLINFO lpsi, BOOL bRedraw);
BOOL GetScrollInfo(HWND hWnd, int nBar, LPCSCROLLINFO lpsi);
相关数据与数据结构:
typedef struct tagSCROLLINFO
{
UINT cbSize;//设置为sizeof(SCROLLINFO)
UINT fMask;//要设置或获取的值
int nMin;//范围的最小值
int nMax;//范围的最大值
UINT nPage;//页面大小
int nPos;//当前位置
int nTrackPos;//当前追踪位置
} SCROLLINFO, FAR *LPSCROLLINFO;
UINT cbSize;//设置为sizeof(SCROLLINFO)
UINT fMask;//要设置或获取的值
int nMin;//范围的最小值
int nMax;//范围的最大值
UINT nPage;//页面大小
int nPos;//当前位置
int nTrackPos;//当前追踪位置
} SCROLLINFO, FAR *LPSCROLLINFO;
fMask字段是一个或多个以SIF为前缀的标识,他们可以用或运算组合在一起
SIF_RANGE: 在SetScrollInfo中必须在nMin和nMax中指定滚动条的范围, 使用GetScrollInfo获取滚动条范围
SIF_POS:与上述类似,通过nPos字段获取或指定滚动条位置
SIF_PAGE:与上述类似,通过nPage字段来获取或指定页面大小。
SIF_TRACKPOS:只用在GetScrollInfo中,而且只处理通知码是SB_THUMBTRACK或SB_THUMBPOSITION的WM_VSCROLL或WM_HSCROLL消息nTrackPos字段将返回当前滑块位置
SIF_DISABLENOSCROLL标识只用在SetScrollInfo中,当设定了这个标识后,被隐藏的滚动条将变为被禁用的滚动条。
SIF_ALL标识是SIF_RANGE、SIF_POS、SIF_PAGE、SIF_TRACKPOS的组合
iBar参数为SB_HORZ或SB_VERT。
相关消息:
WM_VSCROLL(垂直滚动条), WM_HSCROLL(水平滚动条)
其中,lParam可以被忽略,wParam的低位字为:
#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
当低位字为SB_THUMBTRACK时,wParam的高位字为滑块当前位置,当低位字为SB_THUMBPOSITION时,高位字为鼠标键送开始滑块的位置。
1:在程序的窗口中包含滚动条:
只需要在CreateWindow的第三个参数中包括窗口风格标识符WS_VSCROLL或WS_HSCROLL或同时包含两者。
2:设置滚动条的范围:
SetScrollRange(hWnd, iBar, iMin, iMax, bRedraw);
该函数的范围之为滑块的当前位置,iBar参数可以为SB_VERT或者SB_HORZ, 当设置范围后需要重回滚动条时,bRedraw参数应为TRUE
3:设置滚动条位置:
SetScrollPos(hWnd, iBar, iPos, bRedraw);
该函数的返回值亦为滑块当前位置,iPos应为[iMin, iMax]范围中的值。当用户拖动滑块(消息的wParam参数的低位字为
SB_THUMBTRACK或者
SB_THUMBPOSITION)时,应使用该函数来修改滑块的位置,否则滑块将在用户鼠标松开后恢复原来的位置
4:消息处理
程序可以处理
SB_THUMBTRACK或
SB_THUMBPOSITION消息,但很少同时处理两者。前者需要在滑块滑动时移动客户区的内容,后者只需要在用户停止拖动滑块式更新客户去的内容。同时,程序还可以处理其他相关的消息,详见相关程序2。
5:程序的绘制代码的结构:
程序在处理滚动条消息时不应直接绘制客户区,相反,应该调用InvalidateRect函数使客户区无效,接着调用UpdateWindow(hWnd);来重绘客户区。
6:程序结构:
以文本编辑器为例,字体的改变与字体信息的初始化应放在WM_CREATE消息中,而SCROLLINFO的初始化应放在WM_SIZE消息中进行处理。详见相关程序2。
相关程序1:
BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
hInst = hInstance; // 将实例句柄存储在全局变量中
HWND hWnd = CreateWindowW(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW | WS_VSCROLL,
CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, nullptr, nullptr, hInstance, nullptr);
if (!hWnd)
{
return FALSE;
}
ShowWindow(hWnd, nCmdShow);
UpdateWindow(hWnd);
return TRUE;
}
相关程序2:
LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
static int cxChar, cyChar, cxCaps, cxClient, cyClient, iMaxWidth, iMaxLine;
HDC hdc;
int i, x, y, iVertpos, iPaintBeg, iPaintEnd;
SCROLLINFO si;
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;//如果为等宽字体,则低位为0,如果为变宽字体,地位为1,大写字母的宽度为小写字母宽度的3/2
cyChar = tm.tmHeight + tm.tmExternalLeading;
ReleaseDC(hWnd, hdc);
}
break;
case WM_SIZE:
{
cxClient = LOWORD(lParam);//获取客户区尺寸
cyClient = HIWORD(lParam);
iMaxLine = cyClient / cyChar;
si.cbSize = sizeof(si);
si.fMask = SIF_RANGE | SIF_PAGE;
si.nMin = 0;
si.nMax = iMaxLine;
si.nPage = iMaxLine;
SetScrollInfo(hWnd, SB_VERT, &si, true);
iMaxWidth = cxClient / cxCaps;//每行输出的字数
}
break;
case WM_VSCROLL:
{
si.cbSize = sizeof(si);
si.fMask = SIF_ALL;
GetScrollInfo(hWnd, SB_VERT, &si);
iVertpos = si.nPos;
switch (wParam & 0xffff)
{
case SB_TOP:
si.nPos = si.nMin;
break;
case SB_BOTTOM:
si.nPos = si.nMax;
break;
case SB_LINEUP:
si.nPos -= 1;
break;
case SB_LINEDOWN:
si.nPos += 1;
break;
case SB_PAGEUP:
si.nPos -= si.nPage;
si.nPos = (si.nPos < 0 ? 0 : si.nPos);
break;
case SB_PAGEDOWN:
si.nPos += si.nPage;
si.nPos = (si.nPos > si.nMax ? si.nMax : si.nPos);
break;
case SB_THUMBTRACK:
si.nPos = si.nTrackPos;
break;
default:
break;
}
si.fMask = SIF_POS;
SetScrollInfo(hWnd, SB_VERT, &si, true);
GetScrollInfo(hWnd, SB_VERT, &si);
if (si.nPos != iVertpos)
{
ScrollWindow(hWnd, 0, cyChar * (iVertpos - si.nPos), nullptr, nullptr);
UpdateWindow(hWnd);
}
}
break;
case WM_COMMAND:
{
int wmId = LOWORD(wParam);
// 分析菜单选择:
switch (wmId)
{
case IDM_ABOUT:
DialogBox(hInst, MAKEINTRESOURCE(IDD_ABOUTBOX), hWnd, About);
break;
case IDM_EXIT:
DestroyWindow(hWnd);
break;
default:
return DefWindowProc(hWnd, message, wParam, lParam);
}
}
break;
case WM_KEYDOWN:
{
TCHAR tchar[10];
int istate = GetKeyState('A');
swprintf_s(&tchar[0], 10, TEXT(" %d "), istate);
MessageBox(hWnd, &tchar[0], &tchar[0], MB_OK);
}
case WM_PAINT:
{
PAINTSTRUCT ps;
hdc = BeginPaint(hWnd, &ps);
// TODO: 在此处添加使用 hdc 的任何绘图代码...
si.cbSize = sizeof(si);
si.fMask = SIF_POS;
GetScrollInfo(hWnd, SB_VERT, &si);
iVertpos = si.nPos;
TextOut(hdc, 100, cyClient / 2 - iVertpos, TEXT("OPen_PI"), 7);
EndPaint(hWnd, &ps);
}
break;
case WM_DESTROY:
PostQuitMessage(0);
break;
default:
return DefWindowProc(hWnd, message, wParam, lParam);
}
return 0;
}
WinMain函数和与其他相关函数
int APIENTRY wWinMain(_In_ HINSTANCE hInstance,
_In_opt_ HINSTANCE hPrevInstance,
_In_ LPWSTR lpCmdLine,
_In_ int nCmdShow)
{
UNREFERENCED_PARAMETER(hPrevInstance);
UNREFERENCED_PARAMETER(lpCmdLine);
// TODO: 在此放置代码。
// 初始化全局字符串
LoadStringW(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
LoadStringW(hInstance, IDC_KEYBOARD, szWindowClass, MAX_LOADSTRING);
MyRegisterClass(hInstance);
// 执行应用程序初始化:
if (!InitInstance (hInstance, nCmdShow))
{
return FALSE;
}
HACCEL hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDC_KEYBOARD));
MSG msg;
// 主消息循环:
while (GetMessage(&msg, nullptr, 0, 0))
{
if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
return (int) msg.wParam;
}
//
// 函数: MyRegisterClass()
//
// 目的: 注册窗口类。
//
ATOM MyRegisterClass(HINSTANCE hInstance)
{
WNDCLASSEXW wcex;
wcex.cbSize = sizeof(WNDCLASSEX);
wcex.style = CS_HREDRAW | CS_VREDRAW;
wcex.lpfnWndProc = WndProc;
wcex.cbClsExtra = 0;
wcex.cbWndExtra = 0;
wcex.hInstance = hInstance;
wcex.hIcon = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_KEYBOARD));
wcex.hCursor = LoadCursor(nullptr, IDC_ARROW);
wcex.hbrBackground = (HBRUSH)(COLOR_WINDOW+1);
wcex.lpszMenuName = MAKEINTRESOURCEW(IDC_KEYBOARD);
wcex.lpszClassName = szWindowClass;
wcex.hIconSm = LoadIcon(wcex.hInstance, MAKEINTRESOURCE(IDI_SMALL));
return RegisterClassExW(&wcex);
}