ActivityDesigner Class

Provides a mandatory base class for all activity designer components.

Namespace:  System.Workflow.ComponentModel.Design
Assembly:  System.Workflow.ComponentModel (in System.Workflow.ComponentModel.dll)

public class ActivityDesigner : IDesignerFilter, 
	IToolboxUser, IPersistUIState, IWorkflowRootDesigner, IRootDesigner, IDesigner, 

All activity designer components derive from ActivityDesigner. The ActivityDesigner provides a simple designer which lets the user visually design activities in the design mode.

ActivityDesigner provides a simple mechanism for the activities so they can participate in rendering the workflow on the design surface.

ActivityDesigner lets the user customize layout and drawing associated with the activity.

ActivityDesigner lets the user extend the metadata associated with the activity.

The following example shows a complete implementation of an ActivityDesigner for a custom activity. The designer has a flag that can be toggled to allow the base class ActivityDesigner to control the painting or to utilize the various methods the ActivityDesignerPaint class to draw the activity.

public class CustomActivityDesigner : ActivityDesigner
    public override bool CanBeParentedTo(CompositeActivityDesigner parentActivityDesigner)
        if (parentActivityDesigner.GetType().ToString() == "System.Workflow.Activities.IfElseBranchDesigner")
            return false;

        return true;

    private ActivityDesignerVerbCollection verbs = null;

    protected override ActivityDesignerVerbCollection Verbs
            if (this.verbs == null)

            return this.verbs;

    private void CreateActivityVerbs()
        this.verbs = new ActivityDesignerVerbCollection();

        ActivityDesignerVerb addBranchVerb = new ActivityDesignerVerb(this,
            DesignerVerbGroup.View, "Add New Parallel Branch", new EventHandler(OnAddParallelBranch));


    protected void OnAddParallelBranch(object sender, EventArgs e)
        // Code for adding a new branch to the parallel activity goes here

    protected override Rectangle ImageRectangle
            Rectangle bounds = this.Bounds;
            Size sz = new Size(24, 24);

            Rectangle imageRect = new Rectangle();
            imageRect.X = bounds.Left + ((bounds.Width - sz.Width) / 2);
            imageRect.Y = bounds.Top + 4;
            imageRect.Size = sz;

            return imageRect;

    protected override Rectangle TextRectangle
            return new Rectangle(
                this.Bounds.Left + 2,
                this.Bounds.Width - 4,
                this.Bounds.Height - this.ImageRectangle.Height - 1);

    protected override void Initialize(Activity activity)
        Bitmap bmp = Resources.ToolboxImage;
        this.Image = bmp;

    readonly static Size BaseSize = new Size(64, 64);
    protected override Size OnLayoutSize(ActivityDesignerLayoutEventArgs e)
        return BaseSize;

    private bool expanded = true;
    private bool useBasePaint = false;

    public bool UseBasePaint
        get { return this.useBasePaint; }
        set { this.useBasePaint = value; }

    public bool Expanded
        get { return this.expanded; }
        set { this.expanded = value; }

    protected override void OnPaint(ActivityDesignerPaintEventArgs e)
        if (this.UseBasePaint == true)


    private void DrawCustomActivity(ActivityDesignerPaintEventArgs e)
        Graphics graphics = e.Graphics;

        CompositeDesignerTheme compositeDesignerTheme = (CompositeDesignerTheme)e.DesignerTheme;

        ActivityDesignerPaint.DrawRoundedRectangle(graphics, compositeDesignerTheme.BorderPen, this.Bounds, compositeDesignerTheme.BorderWidth);

        string text = this.Text;
        Rectangle textRectangle = this.TextRectangle;
        if (!String.IsNullOrEmpty(text) && !textRectangle.IsEmpty)
            ActivityDesignerPaint.DrawText(graphics, compositeDesignerTheme.Font, text, textRectangle, StringAlignment.Center, e.AmbientTheme.TextQuality, compositeDesignerTheme.ForegroundBrush);

        System.Drawing.Image image = this.Image;
        Rectangle imageRectangle = this.ImageRectangle;
        if (image != null && !imageRectangle.IsEmpty)
            ActivityDesignerPaint.DrawImage(graphics, image, imageRectangle, DesignerContentAlignment.Fill);

            new Rectangle(this.Location.X, this.Location.Y, 10, 10),


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2015 Microsoft