ScrollWindow

【勇芳软件工作室】汉化HomePreviousNext

ScrollWindow功能滚动指定窗口的客户区域的内容。此函数存在向后兼容性。对于新的应用程序,请使用ScrollWindowEx功能。

BOOL ScrollWindow(

HWND 【的hWnd】,//处理窗口滚动
INT 【XAmount】,//水平滚动量
INT 【YAmount】,//垂直滚动量
CONST RECT *【LPRECT】,//具有滚动矩形的结构的地址
CONST RECT *【lpClipRect】//具有剪辑矩形的结构的地址
); 

参数

【的hWnd】

标识要滚动客户端区域的窗口。

【XAmount】

指定水平滚动的设备单位数量。如果要滚动的窗口具有CS_OWNDC或CS_CLASSDC样式,则此参数使用逻辑单元而不是设备单位。该参数必须是负值才能向左滚动窗口的内容。

【YAmount】

指定垂直滚动的设备单位数量。如果要滚动的窗口具有CS_OWNDC或CS_CLASSDC样式,则此参数使用逻辑单元而不是设备单位。此参数必须是负值才能向上滚动窗口的内容。

【LPRECT】

指向RECT结构,指定要滚动的客户区域的部分。如果此参数为NULL,则将滚动整个客户机区域。

【lpClipRect】

指向包含裁剪矩形坐标的RECT结构。只有剪裁矩形中的设备位才会受到影响。从矩形外部滚动到内侧的位被画;从矩形的内部滚动到外面的位没有画。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

如果插入符在滚动的窗口中,ScrollWindow将自动隐藏插入符,以防止其被删除,然后在滚动完成后恢复插入符号。相应地调整插入位置。

ScrollWindow未覆盖的区域未重绘,但将其组合到窗口的更新区域。应用程序最终会收到一条WM_PAINT消息,通知该区域必须重画。要重新绘制未覆盖区域,滚动操作同时在调用ScrollWindow后立即调用UpdateWindow函数。

如果【LPRECT】参数为NULL,则窗口中任何子窗口的位置将被【XAmount】【YAmount】参数指定的量偏移;窗口中的无效(未上漆)区域也被偏移。ScrollWindow【LPRECT】为NULL时更快。

如果【LPRECT】不为NULL,则子窗口的位置不会更改,窗口中的无效区域不会被偏移。为防止在【LPRECT】不为NULL时更新问题,请调用UpdateWindow以重新调用ScrollWindow.

也可以看看

RECT, ScrollDC, ScrollWindowEx, UpdateWindow