Delphi WinAPI AnimateWindow - 使您能够在显示或隐藏窗口时产生特殊效果
AnimateWindow //使您能够在显示或隐藏窗口时产生特殊效果。有四种类型的动画:滚动、滑动、折叠或展开,以及alpha混合淡入淡出。
原型:
BOOL AnimateWindow(
[in] HWND hWnd, //要设置动画的窗口的控制柄。调用线程必须拥有此窗口。
[in] DWORD dwTime, //播放动画所需的时间,以毫秒为单位。通常,播放动画需要200毫秒。
[in] DWORD dwFlags //动画的类型。此参数可以是以下一个或多个值。请注意,默认情况下,这些标志在显示窗口时生效。要在隐藏窗口时生效,请使用AW_HIDE和带有适当标志的逻辑OR运算符。
);
参数:
dwFlags //动画的类型。此参数可以是以下一个或多个值。请注意,默认情况下,这些标志在显示窗口时生效。要在隐藏窗口时生效,请使用AW_HIDE和带有适当标志的逻辑OR运算符。
-
- AW_ACTIVATE //激活窗口。不要将此值用于AW_HIDE。
- AW_BLEND //使用渐变效果。只有当hwnd是顶级窗口时,才能使用此标志。
- AW_CENTER //如果使用AW_HIDE,则使窗口显示为向内折叠;如果未使用AW_HIDE,则使窗口显示为向外展开。不同的方向标志无效。
- AW_HIDE //隐藏窗口。默认情况下,将显示该窗口。
- AW_HOR_POSITIVE //从左到右设置窗口的动画。此标志可用于滚动或滑动动画。当与AW_CENTER或AW_BLEND一起使用时,它将被忽略。
- AW_HOR_NEGATIVE //从右向左设置窗口的动画。此标志可用于滚动或滑动动画。当与AW_CENTER或AW_BLEND一起使用时,它将被忽略。
- AW_SLIDE //使用幻灯片动画。默认情况下,使用滚动动画。与AW_CENTER一起使用时,此标志将被忽略。
- AW_VER_POSITIVE //从上到下设置窗口动画。此标志可用于滚动或滑动动画。当与AW_CENTER或AW_BLEND一起使用时,它将被忽略。
- AW_VER_NEGATIVE //从下到上设置窗口的动画。此标志可用于滚动或滑动动画。当与AW_CENTER或AW_BLEN一起使用时,它将被忽略
返回值(类型:布尔):
- 如果函数成功,则返回值为非零。
- 如果函数失败,返回值为零。在以下情况下,该功能将失败:
- 如果窗口已经可见,并且您正在尝试显示该窗口。
- 如果窗口已隐藏,而您正试图隐藏窗口。
- 如果没有为滑动或滚动动画指定方向。
- 尝试使用AW_BLEND设置子窗口的动画时。
- 如果线程不拥有窗口。请注意,在本例中,AnimateWindow失败,但GetLastError返回ERROR_SUCCESS。
要获取扩展的错误信息,请调用GetLastError函数。
其他:
- 使用滑动或滚动动画时,必须指定方向。它可以是AW_HOR_POSITIVE, AW_HOR_NEGATIVE, AW_VER_POSITIVE, or AW_VER_NEGATIVE。
- 可以将AW_HOR_POSITIVE or AW_HOR_NEGATIVE with AW_VER_POSITIVE or AW_VER_NEGATIVE组合起来,以对角设置窗口动画。
- 窗口及其子窗口的窗口过程应处理任何WM_PRINT或WM_PRINTCLIENT消息。对话框、控件和常用控件已经可以处理WM_PRINTCLIENT。默认窗口过程已经处理WM_打印。
- 如果子窗口显示为部分剪裁,则在设置动画时,其剪裁处将有孔。
- AnimateWindow支持RTL窗口。
- 避免为有阴影的窗口设置动画,因为它会产生视觉上分散注意力的、不稳定的动画。
创建时间:2022.03.28 更新时间: