AnimateWindow

原文链接 -> 传送门

函数功能：

AnimateWindow 函数用于在显示或者隐藏窗口时制造特殊的效果。在这有四种类型的动画效果：滚动，滑动，折叠或展开，和阿尔法混合淡出。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI AnimateWindow(
  _In_ HWND  hwnd,
  _In_ DWORD dwTime,
  _In_ DWORD dwFlags
);

参数解析：

返回值：

1. 如果该函数运行成功，则返回值为非 0；

2. 如果该函数运行失败，则返回值为 0。

在下列情况下，该函数将运行失败：

• 如果窗口已经可见，并且你还要试图去显示窗口
• 如果窗口已经被隐藏，并且你还要试图去隐藏窗口
• 如果没有直接指定滑动动画或者滚动动画的方向
• 当你试图去用 AW_BLEND 标识动画显示一个子窗口时
• 如果线程不拥有窗口；注意，在这种情况下，AnimateWindow 函数会运行失败，但是 GetLastError 函数会返回 ERROR_SUCCESS

想要调用更多的错误信息，请调用 GetLastError 函数。


备注：

1. 想要显示或者隐藏一个不带有特殊效果的窗口，请用 ShowWindow 函数。

2. 当用滑动动画或者滚动动画时，你必须指明方向。该方向可以是 AW_HOR_POSITIVE 标识，AW_HOR_NEGATIVE 标识，AW_VER_POSITIVE 标识，或者 AW_VER_NEGATIVE 标识中的任意一个。

3. 你可以将 AW_HOR_POSITIVE 标识或 AW_HOR_NEGATIVE 标识与 AW_VER_POSITIVEH 或 AW_VER_NEGATIVE 标识组合，用来在对角线方向上动画显示一个窗口。

4. 窗口和该窗口的子窗口的窗口程序将会处理任何 WM_PRINT 消息或者 WM_PRINTCLIENT 消息。对话框，控件，和通用控件已经处理了 WM_PRINTCLIENT 消息。默认的窗口程序早已经处理了 WM_PRINT 消息。

5. 如果子窗口被缩短后部分显示，那么当该窗口动画显示时，在该窗口被缩短的地方将有洞。

6. AnimateWindow 函数支持 RTL 窗口。

7. 要避免动画显示一个有阴影窗口，因为该阴影会产生视觉上的干扰、笨拙的动画。


需求：