Windows API(Application Programming Interface,
应用程序编程接口)函数,该函数滚动指定
窗体客户区域的目录。
函数原型
int ScrollWindowEx(
HWND hWnd, // handle to window
int dx, // horizontal scrolling
int dy, // vertical scrolling
CONST RECT *prcScroll, // client area
CONST RECT *prcClip, // clipping rectangle
HRGN hrgnUpdate, // handle to update region
LPRECT prcUpdate, // invalidated region
UINT flags // scrolling options
);
函数参数
hWnd:客户区域将被滚动的窗体句柄。
dx:在设备单元中,指定水平滚动数量。在向左滚动时此参数必须为负。
dy:在设备单元中,指定垂直滚动数量。在向上滚动时此参数必须为负。
prcScroll:指向RECT结构,它指定了将被滚动的客户区域部分。
prcClip:指向包含了类似于被剪下
矩形的RECT结构。只有在剪下内部的小块图形才受影响。从
矩形外向内部的滚动部分将被着色;而从内向外的滚动部分将不再被着色。
hrgnUpdate:处理已被修改的区域,保存这些由于滚动而无效的区域。此参数可以为空。
prcUpdate:指向RECT结构,它接收由于滚动使得
矩形无效部分的边界。此参数值可以为空。
flags:指定控制滚动的标志。这个参数可以是下面的值:
SW_ERASE:通过发送WM_ERASEBKGND消息给窗体。
SW_INVALIDATE:在滚动后,使得由参数hrgnUpdate标识的无效区域被擦除。
SW_SCROLLCHILDREN:动所有由参数prcScroll指出交叉重叠
矩形的子
窗体。子
窗体按照dx和dy规定的像素个数滚动。系统发送消息给所有由prcScroll指出交叉重叠
矩形的子
窗体,即使他们不移动。
返回值:如果函数运行成功,返回值为SIMPLEREGION(
矩形的无效区域),COMPLEXREGION(非矩形的无效区域)或NULLREGION(没有使无效的区域)如果函数运行失败,返回值为ERROR。若想获得更多的
错误信息,请调用GetLastError函数。
注意:如果SW_INVALIDATE和SW_ERASE标志没有被设定,那么函数ScrollWindowEx不能使滚动离开的区域失效。如果其中任意一个标志被设置,ScrollWindowEx函数就可以使区域无效。这块区域将不再被更新直到应用程序调用theUpdateWindow函数,调用theRedrawWindow函数(指定RDW_UPDATENOW或RDW_ERASENOW标志)或是从申请队列中找到WM_PAINT消息。
如果
窗体拥有WS_CLIPCHILDREN类型,那么由hrgnUpdate和prcUpdate指定的返回区域描述了必须更新的滚动窗体的全部区域,包括所需更新子窗体的任何区域。
若SW_SCROLLCHILDREN标志被设置,在子
窗体被滚动时,系统将不能完全更新屏幕。位于
矩形外边的滚动子
窗体部分不被擦除,也不在它的新方向上被重画。为了移动子
窗体使之完全不在prcScroll指定的
矩形条中,可使用DeferWindowPos函数。若标志SW_SCROLLCHILDREN被设置并且^符号交叉滚动
矩形,则
光标也重新设置。
所有输入输出均被定义为客户端如果有必要,使用IptoDP和dptoLP函数转换逻辑相关性。
Windows CE:参数flags不支持SW_SCROLLCHILDREN。参数dx和dy中只有一个为零。
速查:Windows NT 3.1、Windows 95、Windows CE 1.0以上,头文件:winuser.h;库文件:user32.lib。
比较
WindowEx和DC
相同点
a)两者都可以将某区域滚动到另外一区域,同时计算脏区域。
b)两者最终的实现都是通过内部的BitBlt实现的。
c)如果要对重绘的区域进行精细的管理和计算,则传入hrfgUpdate,否则传入prcUpdate即可。
不同点
a)
ScrollDC只是用于DC,因此它不会发出WM_PAINT进行重绘;而ScrollWindowEx则会。另外就是ScrollWindowEx还可以在滚动时进行其他控制,见flags的值。
b)如果需要滚动整个客户区,则需要用到ScrollWindowEx(来自MSDN),个人觉得
ScrollDC也可以实现。