一种用户小体验 - 从那里来就回到那里去

各位都用过Word2000吧，它的用户界面中有个小动画，你按下Ctl+F弹出查找对话框时，会从右下角显示一个黑色的方框，然后快速移动和放大，最后才显示出查找对话框，当用户关闭查找对话框时刚才的动画就会倒放。

这个用户界面的小体验不错，它清晰的表明了若使用鼠标点击操作时点击何处来打开查找对话框，帮助用户记忆操作过程，这个动画本身就是一个操作帮助和提醒。可以称之为从那里来就回到那里去的过程。

于是我编写了一个 AnimatedRectDrawer 类型来模仿了这种用户体验，这个类型实际上是Win32API函数 DrawAnimatedRects 用C#的一个包装。它可以将子窗体和主窗体上的某个按钮或其他控件绑定，当用户点击按钮时，子窗体将从这个按钮上动态的弹出来，用户关闭子窗体时，子窗体将动态的收缩到按钮中。过程很形象，而且用户比较牢固的记下按钮和子窗体的关系。

整个代码如下，在Win2000下调试成功。

 

//#define DOTNET20

using System;
using System.Text;

namespace XDesignerWindows32
{

//
// ！！！！！！！！！ 注意 ！！！！！！！！！！！！！！！！
//
//.NET1.1的窗体关闭事件 Form.Closed 在 .NET2.0中是过时的。在.NET2.0环境中
//
// 应当使用 Form.FormClosed 事件,这两个事件名称和使用的委托类型都不一样,为此
//
// 定义一个名为 DOTNET20 的条件编译标志,若编译环境使用.NET1.1则不需要定义这个
//
// 条件编译变量,若编译环境使用 .NET2.0则建议定义这个条件编译标记，即在代码文件
//
// 的第一行添加 #define DOTNET20
//
// 由于.NET2.0保持兼容性还支持Form.Closed事件，因此当不定义这个条件编译标记而
//
// 使用 Form.Closed 事件仍然可以编译通过,但仍建议进行上述的处理。
//
// 袁永福( http://www.xdesigner.cn ) 2006-12-12
//
//
// !!!!!!!!!!!!!!! Notice !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
//
// Form.Close event used in .NET1.1 is old in .NET2.0 . In .NET2.0 , It is
//
// replace by Form.FormClosed , The two event 's name and delegate type is
//
// different , so there are define a pre-compile flag named DOTNET20 , when
//
// you compile this code use .NET1.1 , you did not define this pre-compile
//
// flag , but when you compile use .NET2.0 , I advice you define this pre-compile
//
// flag , just add "#define DOTNET20" at the begin of this code file .
//
// For compatibility , .NET2.0 support Form.Close , so if you did not define this
//
// pre-compile flag and use Form.Close event , you can compile success , but I
//
// still advice you define the DOTNET20 flag needed .
//
// yfyuan ( http://www.xdesigner.cn/default-eng.htm ) 2006-12-12
//

/// <summary>
/// 绘制矩形动画的模块,本模块为Win32API函数 DrawAnimatedRects 的一个包装
///
/// Draw animate rectangle , this class is a package of Win32API
///
/// function DrawAnimatedRects
///
/// </summary>
/// <remarks>
/// 编写 袁永福( http://www.xdesigner.cn ) 2006-12-12
///
/// Author yfyuan ( http://www.xdesigner.cn/default-eng.htm ) 2006-12-12
/// </remarks>
public class AnimatedRectDrawer
{
/// <summary>
/// 注册项目类型
///
/// Information of regite form
/// </summary>
public class DrawInfoItem
{
/// <summary>
/// 原始控件
///
/// Source Control
/// </summary>
public System.Windows.Forms.Control SourceControl = null;
/// <summary>
/// 原始区域
///
/// Source Rectangle
/// </summary>
public System.Drawing.Rectangle SourceRect = System.Drawing.Rectangle.Empty;
/// <summary>
/// 目标窗体
///
/// Desc Form object
/// </summary>
public System.Windows.Forms.Form Form = null;
/// <summary>
/// 对象额外数据
///
/// object's extern data
/// </summary>
public object Tag = null;
}

/// <summary>
/// 初始化对象
///
/// Init object
/// </summary>
public AnimatedRectDrawer()
{

#if DOTNET20
_FormClosed = new System.Windows.Forms.FormClosedEventHandler(Form_Closed);
#else
_FormClosed = new System.EventHandler(Form_Closed);
#endif
_FormLoad = new EventHandler(Form_Load);
}
/// <summary>
/// 添加项目
///
/// Add item
/// </summary>
/// <param name="ctl">原始控件 Source control</param>
/// <param name="rect">原始矩形 source rectangle</param>
/// <param name="frm">目标窗体 desc form</param>
/// <returns>新增的项目对象 the item instance added </returns>
public DrawInfoItem Add(
System.Windows.Forms.Control ctl,
System.Drawing.Rectangle rect,
System.Windows.Forms.Form frm)
{
DrawInfoItem item = GetItem(frm);
if (item == null)
{
item = new DrawInfoItem();
myItems.Add(item);
frm.Load += _FormLoad;
#if DOTNET20
frm.FormClosed += _FormClosed;
#else
frm.Closed += _FormClosed;
#endif
}
item.SourceControl = ctl;
item.SourceRect = rect;
item.Form = frm;
return item;
}
/// <summary>
/// 添加项目
///
/// Add item
/// </summary>
/// <param name="ctl">原始控件 source control</param>
/// <param name="frm">目标窗体 desc form</param>
/// <returns>新增的项目对象 the item instance added</returns>
public DrawInfoItem Add(
System.Windows.Forms.Control ctl,
System.Windows.Forms.Form frm)
{
return Add(ctl, System.Drawing.Rectangle.Empty, frm);
}
/// <summary>
/// 删除所有项目
/// </summary>
public void Clear()
{
myItems.Clear();
}
/// <summary>
/// 为窗体查找项目对象
/// Search item for specify form instance
/// </summary>
/// <param name="frm">窗体对象 form instance</param>
/// <returns>
/// 找到的项目对象,若未找到则返回空引用
/// item instance finded , if can not find then return null
/// </returns>
public DrawInfoItem GetItem(System.Windows.Forms.Form frm)
{
foreach (DrawInfoItem item in myItems)
{
if (item.Form == frm)
return item;
}
return null;
}

#region 内部代码群 Internal code **************************************
/// <summary>
/// 注册项目列表
///
/// registe information list
/// </summary>
private System.Collections.ArrayList myItems = new System.Collections.ArrayList();
/// <summary>
/// 窗体关闭处理程序委托对象
///
/// the delegate instance handle form close event
/// </summary>
#if DOTNET20
private System.Windows.Forms.FormClosedEventHandler _FormClosed = null;
#else
private System.EventHandler _FormClosed = null;
#endif
/// <summary>
/// 窗体打开处理程序委托对象
///
/// the delegate instance handle form load event
/// </summary>
private System.EventHandler _FormLoad = null;
/// <summary>
/// 窗体打开处理过程 the function handle form load event
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void Form_Load(object sender, System.EventArgs e)
{
DrawInfoItem item = GetItem((System.Windows.Forms.Form)sender);
if (item != null)
{
InnerDraw(item, true);
}

}
/// <summary>
/// 窗体关闭处理过程 the function handle form close event
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
#if DOTNET20
private void Form_Closed(
object sender,
System.Windows.Forms.FormClosedEventArgs e)
#else
private void Form_Closed( object sender , System.EventArgs e )
#endif
{
DrawInfoItem myItem = GetItem((System.Windows.Forms.Form)sender);
if (myItem != null)
{
myItems.Remove(myItem);
InnerDraw(myItem, false);
}
}
/// <summary>
/// 内部的绘制动画的过程 interior function to draw animate rectangle
/// </summary>
/// <param name="item">绘制信息对象 registe information</param>
/// <param name="bolOpen">
/// 是否显示为打开过程
/// draw animate as open form
/// </param>
private void InnerDraw(DrawInfoItem item, bool bolOpen)
{
if (item == null)
return;

if (item.SourceControl == null || item.Form == null)
return;

System.Drawing.Rectangle srect = this.GetScreenRect(
item.SourceRect,
item.SourceControl);

if (srect.IsEmpty)
return;

System.Drawing.Rectangle trect = this.GetScreenRect(
System.Drawing.Rectangle.Empty,
item.Form);

if (trect.IsEmpty)
return;

RECT rect1 = new RECT();
rect1.left = srect.Left;
rect1.top = srect.Top;
rect1.right = srect.Right;
rect1.bottom = srect.Bottom;

RECT rect2 = new RECT();
rect2.left = trect.Left;
rect2.top = trect.Top;
rect2.right = trect.Right;
rect2.bottom = trect.Bottom;

if (bolOpen)
DrawAnimatedRects(item.Form.Handle, IDANI_CAPTION, ref rect1, ref rect2);
else
DrawAnimatedRects(item.Form.Handle, IDANI_CAPTION, ref rect2, ref rect1);
}

private System.Drawing.Rectangle GetScreenRect(
System.Drawing.Rectangle rect,
System.Windows.Forms.Control ctl)
{
System.Drawing.Rectangle result = System.Drawing.Rectangle.Empty;
if (ctl == null)
{
result = rect;
}
else
{
result = GetControlBounds(ctl);
if (rect.IsEmpty)
result = GetControlBounds(ctl);
else
{
result = rect;
result.Location = ctl.PointToScreen(result.Location);
}
}
return result;
}
/// <summary>
/// 获得控件在屏幕中的矩形区域 get a control's bounds in screeen
/// </summary>
/// <param name="ctl">控件对象 control instance</param>
/// <returns>矩形区域对象 bounds in screen</returns>
private System.Drawing.Rectangle GetControlBounds(System.Windows.Forms.Control ctl)
{
if (ctl == null)
return System.Drawing.Rectangle.Empty;
if (ctl.IsHandleCreated)
{
RECT rect = new RECT();
if (GetWindowRect(ctl.Handle, ref rect))
{
return new System.Drawing.Rectangle(
rect.left,
rect.top,
rect.right - rect.left,
rect.bottom - rect.top);
}
}
return ctl.Bounds;
}

#endregion

#region 声明Win32API函数以及结构 declare Win32API function and structure

private const int IDANI_CAPTION = 0x3;
private const int IDANI_CLOSE = 0x2;
private const int IDANI_OPEN = 0x1;

private struct RECT
{
public int left;
public int top;
public int right;
public int bottom;
}

[System.Runtime.InteropServices.DllImport("user32.dll")]
private static extern bool DrawAnimatedRects(
IntPtr hwnd,
int Ani,
ref RECT from,
ref RECT to);

[System.Runtime.InteropServices.DllImport("user32.dll")]
private static extern bool GetWindowRect(IntPtr hwnd, ref RECT rect);

#endregion
}//public class AnimatedRectDrawer

/// <summary>
/// 测试 AnimatedRectDrawer 的功能的一个窗体
///
/// A form which test AnimatedRectDrawer's function
/// </summary>
public class AnimatedRectDrawerTestForm : System.Windows.Forms.Form
{
public AnimatedRectDrawerTestForm()
{
this.StartPosition = System.Windows.Forms.FormStartPosition.CenterScreen;
this.Text = "从那里来就回到那里去 - Where come from , where come back";

btn = new System.Windows.Forms.Button();
this.Controls.Add(btn);
btn.Text = "Open";
btn.Location = new System.Drawing.Point(30, 30);
btn.Click += new EventHandler(btn_Click);
}

private AnimatedRectDrawer drawer = new AnimatedRectDrawer();
System.Windows.Forms.Button btn = null;

void btn_Click(object sender, EventArgs e)
{
System.Windows.Forms.Form frm = new System.Windows.Forms.Form();
drawer.Add(btn, frm);
frm.Owner = this;
frm.Show();
}

/// <summary>
/// Entrance function
/// </summary>
[STAThread]
static void Main()
{
System.Windows.Forms.Application.Run(new AnimatedRectDrawerTestForm());
}
}//public class AnimatedRectDrawerTestForm : System.Windows.Forms.Form
}

袁永福 ( http://www.xdesigner.cn ) 2006-12-12