ScrollWindow

小甲鱼

函数功能：

ScrollWindow 函数滚动指定窗口的客户区内容。

注意：该函数提供了向后兼容性，新的应用程序应该使用 ScrollWindowsEx 函数代替。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

1. 
   
2. BOOL ScrollWindow(
   
3.   _In_  HWND hWnd,
   
4.   _In_  int XAmount,
   
5.   _In_  int YAmount,
   
6.   _In_  const RECT *lpRect,
   
7.   _In_  const RECT *lpClipRect
   
8. );

复制代码

参数解析：

参数	含义
hWnd	指向客户区将被滚动的窗口句柄
XAmount	1. 在设备单元中，指定水平滚动的数量 2. 如果窗口类风格为 CS_OWNDC 或 CS_CLASSDC，则此参数则使用逻辑单元而非设备单元 3. 当向左滚动窗口的内容时，该参数的值必须是负数
YAmount	1. 在设备单元中，指定垂直滚动的数量 2. 如果窗口类风格为 CS_OWNDC 或 CS_CLASSDC，则此参数则使用逻辑单元而非设备单元 3. 当向上滚动窗口的内容时，该参数的值必须是负数
lpRect	1. 指向 RECT 结构指针，该结构指定了将要滚动的客户区范围 2. 如果此参数为 NULL，则整个客户区域将被滚动
lpClipRect	1. 指向 RECT 结构指针，该结构指定了要滚动的裁剪区域 2. 只有这个矩形中的内容才会被滚动（在矩形之外的内容不会被影响，即使它们是在 lpRect 指定的矩形之内）

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。


备注：

1. 如果在被滚动的窗口中含有插入符，ScrollWindow 函数将自动隐藏插入符，以防它被擦掉。当滚动结束后再恢复插入符，插入符的位置相应的被调整。

2. 未被 ScrollWindow 函数覆盖的区域不会被重绘，但该区域会与窗口更新区域组合，当应用程序最终收到 WM_PAINT 的消息时，组合区域统一重绘。为了在滚动操作的同时重画未覆盖区域，则应在调用 ScrollWindow 函数后马上调用 UpdateWindow 函数。

3. 如果 lpRect 参数的值为 NULL，则窗口中的任何子窗口的位置由参数 XAmount 和 Yamount 的数值决定移动距离；窗口中无效的区域（未重绘）也会移动。

4. 当 lpRect 参数为 NULL 时，ScrollWindow 函数可以执行得更快。

5. 如果 lpRect 参数不为 NULL，则窗口中的子窗口的位置不改变，窗口中无效的区域（未重绘）也不移动。为了防止 lpRect 参数不为 NULL 时更新的问题，需要在调用 ScrollWindow 函数前调用 UpdateWindow 函数重绘窗口。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。

感叹下：能把例子都认真翻译过来的...才是真正的情怀吖......

1. 
   
2. /* -------------------------------------------------------------------
   
3.                  【API档案】ScrollWindow 函数使用例子
   
4.                      鱼C工作室 -- www.fishc.com
   
5. --------------------------------------------------------------------*/
   
6. LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
   
7. {
   
8.         HDC hdc;
   
9.         PAINTSTRUCT ps;
   
10.         TEXTMETRIC tm;
    
11.         SCROLLINFO si;
    
12. 
    
13.         static int xClient;     // 客户区的宽度
    
14.         static int yClient;     // 客户区的高度
    
15.         static int xClientMax;  // 客户区内容显示的最大宽度（超过此宽度则加入滚动条）
    
16. 
    
17.         static int xChar;       // 字体的平均水平宽度
    
18.         static int yChar;       // 字体的垂直高度
    
19.         static int xUpper;      // 字体的大写字符的水平宽度
    
20. 
    
21.         static int xPos;        // 当前水平滚动条滑块的位置
    
22.         static int yPos;        // 当前垂直滚动条滑块的位置
    
23. 
    
24.         int i;                  // 循环计数器
    
25.         int x, y;               // 水平和垂直的坐标
    
26. 
    
27.         int FirstLine;          // 失效区域的第一行（需重绘的第一行）
    
28.         int LastLine;           // 失效区域的最后一行（（需重绘的最后一行））
    
29.         HRESULT hr;
    
30.         size_t abcLength;       // 用于存放 abc 数组的长度
    
31. 
    
32.         // 创建要显示的行（呃，打印的内容我就不翻译了吧...）
    
33.         #define LINES 28
    
34.         static TCHAR *abc[] = {
    
35.                 TEXT("anteater"), TEXT("bear"), TEXT("cougar"),
    
36.                 TEXT("dingo"), TEXT("elephant"), TEXT("falcon"),
    
37.                 TEXT("gazelle"), TEXT("hyena"), TEXT("iguana"),
    
38.                 TEXT("jackal"), TEXT("kangaroo"), TEXT("llama"),
    
39.                 TEXT("moose"), TEXT("newt"), TEXT("octopus"),
    
40.                 TEXT("penguin"), TEXT("quail"), TEXT("rat"),
    
41.                 TEXT("squid"), TEXT("tortoise"), TEXT("urus"),
    
42.                 TEXT("vole"), TEXT("walrus"), TEXT("xylophone"),
    
43.                 TEXT("yak"), TEXT("zebra"),
    
44.                 TEXT("This line contains words, but no character. Go figure."),
    
45.                 TEXT("")
    
46.         };
    
47. 
    
48.         switch (message)
    
49.         {
    
50.         case WM_CREATE:
    
51.                 // 获得设备环境句柄
    
52.                 hdc = GetDC(hwnd);
    
53. 
    
54.                 // 获得文本中字体的大小
    
55.                 GetTextMetrics(hdc, &tm);
    
56.                 xChar = tm.tmAveCharWidth;
    
57.                 xUpper = (tm.tmPitchAndFamily & 1 ? 3 : 2) * xChar / 2;
    
58.                 yChar = tm.tmHeight + tm.tmExternalLeading;
    
59. 
    
60.                 // 释放设备环境句柄
    
61.                 ReleaseDC(hwnd, hdc);
    
62. 
    
63.                 // 设置客户区的最大宽度
    
64.                 // （我们这里设置为 48 个小写字符的宽度 + 12 个大写字符的宽度）
    
65.                 xClientMax = 48 * xChar + 12 * xUpper;
    
66. 
    
67.                 return 0;
    
68. 
    
69.         case WM_SIZE:
    
70.                 // 获得客户区的尺寸
    
71.                 yClient = HIWORD(lParam);
    
72.                 xClient = LOWORD(lParam);
    
73. 
    
74.                 // 设置垂直滚动条范围和页面大小（设置页面大小将决定滑块的粗细）
    
75.                 si.cbSize = sizeof(si);
    
76.                 si.fMask = SIF_RANGE | SIF_PAGE;
    
77.                 si.nMin = 0;
    
78.                 si.nMax = LINES - 1;
    
79.                 si.nPage = yClient / yChar;
    
80.                 SetScrollInfo(hwnd, SB_VERT, &si, TRUE);
    
81. 
    
82.                 // 设置水平滚动条范围和页面大小（设置页面大小将决定滑块的粗细）
    
83.                 si.cbSize = sizeof(si);
    
84.                 si.fMask = SIF_RANGE | SIF_PAGE;
    
85.                 si.nMin = 0;
    
86.                 si.nMax = 2 + xClientMax / xChar;
    
87.                 si.nPage = xClient / xChar;
    
88.                 SetScrollInfo(hwnd, SB_HORZ, &si, TRUE);
    
89. 
    
90.                 return 0;
    
91.         case WM_HSCROLL:
    
92.                 // 获得水平滚动条的所有信息
    
93.                 si.cbSize = sizeof (si);
    
94.                 si.fMask = SIF_ALL;
    
95.                 GetScrollInfo(hwnd, SB_HORZ, &si);
    
96. 
    
97.                 // 保存当前滑块位置，迟些进行比较
    
98.                 xPos = si.nPos;
    
99.                 switch (LOWORD(wParam))
    
100.                 {
     
101.                         // 用户点击滚动条左边的三角形
     
102.                 case SB_LINELEFT:
     
103.                         si.nPos -= 1;
     
104.                         break;
     
105. 
     
106.                         // 用户点击滚动条右边的三角形
     
107.                 case SB_LINERIGHT:
     
108.                         si.nPos += 1;
     
109.                         break;
     
110. 
     
111.                         // 用户点击滑块左边的滚动条轴
     
112.                 case SB_PAGELEFT:
     
113.                         si.nPos -= si.nPage;
     
114.                         break;
     
115. 
     
116.                         // 用户点击滑块右边的滚动条轴
     
117.                 case SB_PAGERIGHT:
     
118.                         si.nPos += si.nPage;
     
119.                         break;
     
120. 
     
121.                         // 用户拖动滚动条
     
122.                 case SB_THUMBTRACK:
     
123.                         si.nPos = si.nTrackPos;
     
124.                         break;
     
125. 
     
126.                 default:
     
127.                         break;
     
128.                 }
     
129. 
     
130.                 // 设置滚动条滑块的新位置
     
131.                 si.fMask = SIF_POS;
     
132.                 SetScrollInfo(hwnd, SB_HORZ, &si, TRUE);
     
133. 
     
134.                 // 获得滚动条滑块的位置，由于窗口调整，它可能不是同一个值
     
135.                 GetScrollInfo(hwnd, SB_HORZ, &si);
     
136. 
     
137.                 // 与此前的保存的值进行比较，如果不同则滚动窗口
     
138.                 if (si.nPos != xPos)
     
139.                 {
     
140.                         ScrollWindow(hwnd, xChar * (xPos - si.nPos), 0, NULL, NULL);
     
141.                 }
     
142. 
     
143.                 return 0;
     
144. 
     
145.         case WM_VSCROLL:
     
146.                 // 获得垂直滚动条的所有信息
     
147.                 si.cbSize = sizeof (si);
     
148.                 si.fMask = SIF_ALL;
     
149.                 GetScrollInfo(hwnd, SB_VERT, &si);
     
150. 
     
151.                 // 保存当前滑块位置，迟些进行比较
     
152.                 yPos = si.nPos;
     
153.                 switch (LOWORD(wParam))
     
154.                 {
     
155.                         // 用户点击键盘 Home 按键
     
156.                 case SB_TOP:
     
157.                         si.nPos = si.nMin;
     
158.                         break;
     
159. 
     
160.                         // 用户点击键盘 End 按键
     
161.                 case SB_BOTTOM:
     
162.                         si.nPos = si.nMax;
     
163.                         break;
     
164. 
     
165.                         // 用户点击滚动条上边的三角形
     
166.                 case SB_LINEUP:
     
167.                         si.nPos -= 1;
     
168.                         break;
     
169. 
     
170.                         // 用户点击滚动条下边的三角形
     
171.                 case SB_LINEDOWN:
     
172.                         si.nPos += 1;
     
173.                         break;
     
174. 
     
175.                         // 用户点击滑块上边的滚动条轴
     
176.                 case SB_PAGEUP:
     
177.                         si.nPos -= si.nPage;
     
178.                         break;
     
179. 
     
180.                         // 用户点击滑块下边的滚动条轴
     
181.                 case SB_PAGEDOWN:
     
182.                         si.nPos += si.nPage;
     
183.                         break;
     
184. 
     
185.                         // 用户拖动滚动条
     
186.                 case SB_THUMBTRACK:
     
187.                         si.nPos = si.nTrackPos;
     
188.                         break;
     
189. 
     
190.                 default:
     
191.                         break;
     
192.                 }
     
193. 
     
194.                 // 设置滚动条滑块的新位置
     
195.                 si.fMask = SIF_POS;
     
196.                 SetScrollInfo(hwnd, SB_VERT, &si, TRUE);
     
197. 
     
198.                 // 获得滚动条滑块的位置，由于窗口调整，它可能不是同一个值
     
199.                 GetScrollInfo(hwnd, SB_VERT, &si);
     
200. 
     
201.                 // 与此前的保存的值进行比较，如果不同则滚动窗口
     
202.                 if (si.nPos != yPos)
     
203.                 {
     
204.                         ScrollWindow(hwnd, 0, yChar * (yPos - si.nPos), NULL, NULL);
     
205.                         UpdateWindow(hwnd);
     
206.                 }
     
207. 
     
208.                 return 0;
     
209. 
     
210.         case WM_PAINT:
     
211.                 // 准备绘制
     
212.                 hdc = BeginPaint(hwnd, &ps);
     
213. 
     
214.                 // 获得垂直滚动条的位置
     
215.                 si.cbSize = sizeof (si);
     
216.                 si.fMask = SIF_POS;
     
217.                 GetScrollInfo(hwnd, SB_VERT, &si);
     
218.                 yPos = si.nPos;
     
219. 
     
220.                 // 获得水平滚动条的位置
     
221.                 GetScrollInfo(hwnd, SB_HORZ, &si);
     
222.                 xPos = si.nPos;
     
223. 
     
224.                 // 计算需要重绘的区域
     
225.                 FirstLine = max(0, yPos + ps.rcPaint.top / yChar);
     
226.                 LastLine = min(LINES - 1, yPos + ps.rcPaint.bottom / yChar);
     
227. 
     
228.                 for (i = FirstLine; i <= LastLine; i++)
     
229.                 {
     
230.                         x = xChar * (1 - xPos);
     
231.                         y = yChar * (i - yPos);
     
232. 
     
233.                         // 使用安全字符串函数获得字符串长度
     
234.                         hr = StringCchLength(abc[i], 55, &abcLength);
     
235.                         if ((FAILED(hr)) | (abcLength == NULL))
     
236.                         {
     
237.                                 // 获取字符串长度失败的提示...
     
238.                         }
     
239. 
     
240.                         // 在客户区绘制一行数据
     
241.                         TextOut(hdc, x, y, abc[i], abcLength);
     
242.                 }
     
243. 
     
244.                 // 绘制完毕
     
245.                 EndPaint(hwnd, &ps);
     
246.                 return 0;
     
247. 
     
248.         case WM_DESTROY:
     
249.                 PostQuitMessage(0);
     
250.                 return 0;
     
251.         }
     
252. 
     
253.         return DefWindowProc(hwnd, message, wParam, lParam);
     
254. }
     

复制代码

如在使用上有任何不同，可以参考小甲鱼的《Windows程序设计（SDK）》第 14 讲：滚动条3

隨鈊乄鎍慾

感叹下：能把例子都认真翻译过来的...才是真正的情怀吖......
    感谢！鱼哥！辛苦了.......

lver

鱼哥，为什么我运行后好多错误？

1828058739

lver 发表于 2014-12-20 13:17
鱼哥，为什么我运行后好多错误？

字符打错了，检查下

1828058739

照着打 了一遍，记不住怎么办，尤其是计算字符宽高啊，滚动条的宽高啊

laishiba

慢慢学习

bd214789

再次多谢甲鱼

倚窗听雨

甲鱼哥，WM_PAINT中的x = cxChar  * (1 - xPos)这一行是怎么个情形不是很理解，就卡在着一行里了

lujuzhi1

水平的坐标：1-xPos  这是相对水平第二个位置(第一个位置是0嘛，空两格，写文章开头都空两格啦)的距离，如果这里是i-xPos的话，那每一行的起始位置都不一样咯，文字就是斜的，就成了阶梯式了。说到底就是水平坐标要一致

而垂直坐标就不一样了，因为每一行的垂直坐标都不一行。

lujuzhi1

倚窗听雨 发表于 2015-6-14 17:35
甲鱼哥，WM_PAINT中的x = cxChar  * (1 - xPos)这一行是怎么个情形不是很理解，就卡在着一行里了

水平的坐标：1-xPos  这是相对水平第二个位置(第一个位置是0嘛，空两格，写文章开头都空两格啦)的距离，如果这里是i-xPos的话，那每一行的起始位置都不一样咯，文字就是斜的，就成了阶梯式了。说到底就是水平坐标要一致

而垂直坐标就不一样了，因为每一行的垂直坐标都不一行。

scf

对于水平滚动条，有诸多不理解，为什么跟垂直滚动条不一样呢

zxcmaqi

XAmount和yAmount解释有问题，明明是移动的负值，向右移动才是负数

宋桓公

在学这课的时候，明显体会到，一个程序或者是功能的完善是windows和程序员
协同完成的。滚动条的编程这一点体现的非常的突出。你必须了解windows帮你完成了
什么，你自己需要完成什么。这样才能完善整个功能。

小甲鱼

宋桓公 发表于 2016-7-11 16:43
在学这课的时候，明显体会到，一个程序或者是功能的完善是windows和程序员
协同完成的。滚动条的编程这一 ...

总结得很好，其实耐心学完 SDK，再来看大多数的应用，也就是那么回事~

宋桓公

小甲鱼 发表于 2016-7-11 18:04
总结得很好，其实耐心学完 SDK，再来看大多数的应用，也就是那么回事~

好的～～～

疾风。意破天晴

各位大虾谁能告诉我为什么不在   WM_VSCROLL:  消息后面的  UpdateWindow(hwnd);加上  InvalidateRect(hwnd, NULL, TRUE);
就不能实时更新？

谦虚求学

问下代码里有一段这样写 x=xChar*(1-xPos);还是x=xChar*(i-xPos);

fishermanmax

HRESULT 这个是啥？

neoneo1716

编译不通过

赛赛414

这是啥
错误(活动)        E0144        "const wchar_t *" 类型的值不能用于初始化 "TCHAR *" 类型的实体        one        C:\Users\zc970\source\repos\one\one\源.cpp        93