user32 AnimateWindow API 用法

看到别人程序中使用了此API，稍微学习一下。AnimateWindow主要是实现窗口动画功能。 直接看代码。

using System.Runtime.InteropServices;

namespace User32AnimateWindowAPI
{
    public partial class Form1 : Form
    {
        /// <summary>
        /// 窗口产生动画效果方法。
        /// </summary>
        /// <param name="whnd">产生动画的窗口的句柄</param>
        /// <param name="dwtime">动画持续的时间（以微秒计），完成一个动画的标准时间为200微秒。</param>
        /// <param name="dwflag">动画类型</param>
        /// <returns></returns>
        [DllImport("user32")]
        private static extern bool AnimateWindow(IntPtr whnd, int dwtime, int dwflag);

        #region 动画类型
        //从左到右
        public const Int32 AW_HOR_POSITIVE = 0x00000001;
        //从右到左
        public const Int32 AW_HOR_NEGATIVE = 0x00000002;
        //从上到下
        public const Int32 AW_VER_POSITIVE = 0x00000004;
        //从下到上
        public const Int32 AW_VER_NEGATIVE = 0x00000008;
        //从中间到四周
        public const Int32 AW_CENTER = 0x00000010;
        //隐藏窗口
        public const Int32 AW_HIDE = 0x00010000;
        //淡入淡出效果
        public const Int32 AW_BLEND = 0x00080000;
        //示窗口
        public const Int32 AW_ACTIVATE = 0x00020000;
        #endregion
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            //调用
            AnimateWindow(this.Handle, 3000, AW_CENTER | AW_ACTIVATE);
        }
    }
}

 

AnimateWindow函数说明：

 

  函数功能：该函数能在显示与隐藏窗口时能产生特殊的效果。有两种类型的动画效果：滚动动画和滑动动画。  
  函数原型：BOOL   AnimateWindow（HWND   hWnd，DWORD   dwTime，DWORD   dwFlags）；  
  参数：  
        hWnd：指定产生动画的窗口的句柄。  
        dwTime：指明动画持续的时间（以微秒计），完成一个动画的标准时间为200微秒。  
        dwFags：指定动画类型。这个参数可以是一个或多个下列标志的组合。标志描述：  
  AW_SLIDE：使用滑动类型。缺省则为滚动动画类型。当使用AW_CENTER标志时，这个标志就被忽略 
  AW_ACTIVE：激活窗口。在使用了AW_HIDE标志后不要使用这个标志。  
  AW_BLEND：使用淡出效果。只有当hWnd为顶层窗口的时候才可以使用此标志。  
  AW_HIDE：隐藏窗口，缺省则显示窗口。  
  AW_CENTER：若使用了AW_HIDE标志，则使窗口向内重叠；若未使用AW_HIDE标志，则使窗口向外扩展。  
  AW_HOR_POSITIVE：自左向右显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。  
  AW_HOR_NEGATIVE：自右向左显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。  

  AW_VER_POSITIVE：自顶向下显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。  
  AW_VER_NEGATIVE：自下向上显示窗口。该标志可以在滚动动画和滑动动画中使用。当使用AW_CENTER标志时，该标志将被忽略。  
  返回值：如果函数成功，返回值为非零；如果函数失败，返回值为零。在下列情况下函数将失败：  
  窗口使用了窗口边界；窗口已经可见仍要显示窗口；窗口已经隐藏仍要隐藏窗口。若想获得更多错误信息，请调用GetLastError函数。  
  备注：1) 可以将AW_HOR_POSITIVE或AW_HOR_NEGTVE与AW_VER_POSITVE或AW_VER_NEGATIVE组合来激活一个窗口。  

           2) 可能需要在该窗口的窗口过程和它的子窗口的窗口过程中处理WM_PRINT或WM_PRINTCLIENT消息。对话框，控制，及共用控制已处理WM_PRINTCLIENT消息，缺省窗口过程也已处理WM_PRINT消息。