导航:  Windows Controls Wrapper Functions > Scroll Bar Control > Functions >

ScrollWindowEx

上一页返回章节概述下一页

描述

 

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样式,则hrgnUpdateprcUpdate指定的返回区域表示必须更新的滚动窗口的总面积,包括需要更新的子窗口中的任何区域。

 

如果指定了SW_SCROLLCHILDREN标志,如果子窗口的一部分被滚动,则系统不会正确更新屏幕。

 

无论窗口是否具有CS_OWNDC或CS_CLASSDC类样式,所有输入和输出坐标(对于prcScrollprcClipprcUpdatehrgnUpdate)都被确定为客户端坐标。

 

最低操作系统

 

Windows 95,Windows NT 3.51。

 

引用文件 #INCLUDE Once

 

WinUser.inc