Windows Workflow HOL学习笔记（八）：添加一个Activity Designer

本文内容来自Microsoft Hands-on Labs for Windows Workflow Foundation中的HOL02中的第四个练习，其中包括两个任务：

添加一个验证来检查Email参数。

Ø         添加Activity Designer

Ø         测试Activity Designer

 

在这个练习中，将增强SendMailActivity的设计时界面。

Activity Designer定义了Workflow中activity的直观表示和自定义活动的设计。

 

1．在解决方案资源管理器中，在SendMailActivityLibrary中添加一个Code File，名字为SendMailDesigner.cs。

2．在SendMailDesigner.cs中添加如下代码，其中SendMailDesigner要继承自ActivityDesigner。

using System;

using System.Text;

using System.ComponentModel;

using System.ComponentModel.Design;

using System.Collections.Generic;

using System.Drawing;

using System.Drawing.Drawing2D;

using System.Drawing.Design;

 

using System.Workflow.ComponentModel.Compiler;

using System.Workflow.ComponentModel.Serialization;

using System.Workflow.ComponentModel;

using System.Workflow.ComponentModel.Design;

using System.Workflow.Runtime;

using System.Workflow.Activities;

using System.Workflow.Activities.Rules;

 

namespace SendMailActivityLibrary

{

    public class SendMailDesigner : ActivityDesigner

    {

    }

}

3．我们需要重载3个方法，Initalize、OnPaint和OnLayoutSize，在下面的步骤中将详细描述需要在哪些地方做什么。

4．Initalize，我们将重载这个方法来保存将演示自定义设计Activity引用。我们也需要基类同样初始化。在SendMailDesigner类中输入如下代码：

        SendMailActivity parentActivity;

 

        protected override void Initialize(Activity activity)

        {

            base.Initialize(activity);

            parentActivity = (SendMailActivity)activity;

        }

5．OnLayoutSize方法，覆写这个方法为了给自定义绘出对象提供关于大小的信息。在SendMailDesigner类中输入以下代码：

        protected override Size OnLayoutSize(ActivityDesignerLayoutEventArgs e)

        {

            return new Size(230, 100);

        }

6．OnPaint方法，覆写这个方法为了展现自定义绘图。在SendMailDesigner类中输入以下代码：

            Rectangle frameRect = new Rectangle(this.Location.X, this.Location.Y, this.Size.Width - 5, this.Size.Height - 5);

            Rectangle shadowRect = new Rectangle(frameRect.X + 5, frameRect.Y + 5, frameRect.Width, frameRect.Height);

            Rectangle pageRect = new Rectangle(frameRect.X + 4, frameRect.Y + 24, frameRect.Width - 8, frameRect.Height - 28);

            Rectangle titleRect = new Rectangle(frameRect.X + 15, frameRect.Y + 4, frameRect.Width / 2, 20);

 

            Brush frameBrush = new LinearGradientBrush(frameRect, Color.DarkBlue, Color.LightBlue, 45);

 

            e.Graphics.FillPath(Brushes.LightGray, RoundedRect(shadowRect));

            e.Graphics.FillPath(frameBrush, RoundedRect(frameRect));

            e.Graphics.FillPath(new LinearGradientBrush(pageRect, Color.White, Color.WhiteSmoke, 45), RoundedRect(pageRect));

            e.Graphics.DrawString(Activity.QualifiedName, new Font("Segoe UI", 9), Brushes.White, titleRect);

            frameRect.Inflate(20, 20);

 

            string textToDisplay = String.Format("To : \'{0}\'\r\nFrom : \'{1}\'\r\nSubject : \'{2}\'\r\n", parentActivity.To, parentActivity.From, parentActivity.Subject);

            e.Graphics.DrawString(String.Format(textToDisplay, parentActivity.Subject), new Font("Segoe UI", 8), Brushes.Black, pageRect.X, pageRect.Y + 15);

7．注意到其中调用了RoundedRect公用方法，用来生成圆角显示。下面来编写这个方法。

        private GraphicsPath RoundedRect(Rectangle frame)

        {

            GraphicsPath path = new GraphicsPath();

            int radius = 7;

            int diameter = radius * 2;

 

            Rectangle arc = new Rectangle(frame.Left, frame.Top, diameter, diameter);

 

            path.AddArc(arc, 180, 90);

 

            arc.X = frame.Right - diameter;

            path.AddArc(arc, 270, 90);

 

            arc.Y = frame.Bottom - diameter;

            path.AddArc(arc, 0, 90);

 

            arc.X = frame.Left;

            path.AddArc(arc, 90, 90);

 

            path.CloseFigure();

 

            return path;

        }

8．给SendMailActivity类增加如下Designer属性

    [Designer(typeof(SendMailDesigner), typeof(IDesigner))]

9．生成解决方案。

任务一完成。

 

10．切换到SendMailWorkflow设计视图。SendMailWorkflow的样式变成如下样式：
   

11．在From属性中输入一个错误的Email格式地址，将会出现红色圆圈叹号的提示。

12．将To的Email地址格式修改正确，测试。

13．保存所有文件，并编译退出。

任务二完成。

参考资料：

Microsoft Hands-on Labs for Windows Workflow Foundation