描述
ScrollWindowEx功能滚动指定窗口的客户区的内容。
C/C++ 语法
int ScrollWindowEx( HWND hwnd, int dx, int dy, const RECT *prcScroll, const RECT *prcClip, HRGN hrgnUpdate, LPRECT prcUpdate, UINT flags ); |
PB语法
FUNCTION ScrollWindowEx ( _ BYVAL hwnd AS DWORD, _ BYVAL dx AS LONG, _ BYVAL dy AS LONG, _ BYREF prcScroll AS RECT, _ BYREF prcClip AS RECT, _ BYVAL hrgnUpdate AS DWORD, _ BYREF prcUpdate AS RECT, _ BYVAL flags AS DWORD _ ) AS LONG |
参数
hwnd |
[in]处理要滚动客户区的窗口。 |
dx |
[in]指定水平滚动的设备单位数量。 |
dy |
[in]指定垂直滚动的设备单位数量。 |
prcScroll |
[in]指向RECT结构的指针,指定要滚动的客户区域的部分。 |
prcClip |
[in]指向包含裁剪矩形坐标的RECT结构的指针。 |
hrgnUpdate |
[in]处理被修改为通过滚动来保持该区域无效的区域。 |
prcUpdate |
[out]指向RECT结构的指针,可以通过滚动来接收矩形的边界无效。 |
flags |
[in]指定控制滚动的标志。
SW_ERASE 当使用SW_INVALIDATE标志指定时,通过向窗口发送WM_ERASEBKGND消息来清除新的无效区域。 SW_INVALIDATE 在滚动后使由hrgnUpdate参数标识的区域无效。 SW_SCROLLCHILDREN 滚动与prcScroll参数指向的矩形相交的所有子窗口。 SW_SMOOTHSCROLL Windows 98 / Me,Windows 2000 / XP:使用平滑滚动滚动。 |
返回值
如果函数成功,返回值为SIMPLEREGION(矩形无效区域),COMPLEXREGION(非矩形无效区域,重叠矩形)或NULLREGION(无效区域)。
如果函数失败,返回值为ERROR。
备注
如果未指定SW_INVALIDATE和SW_ERASE标志,ScrollWindowEx不会使滚动的区域无效。
如果窗口具有WS_CLIPCHILDREN样式,则hrgnUpdate和prcUpdate指定的返回区域表示必须更新的滚动窗口的总面积,包括需要更新的子窗口中的任何区域。
如果指定了SW_SCROLLCHILDREN标志,如果子窗口的一部分被滚动,则系统不会正确更新屏幕。
无论窗口是否具有CS_OWNDC或CS_CLASSDC类样式,所有输入和输出坐标(对于prcScroll,prcClip,prcUpdate和hrgnUpdate)都被确定为客户端坐标。
最低操作系统
Windows 95,Windows NT 3.51。
引用文件 #INCLUDE Once
WinUser.inc