Click here to Skip to main content
15,867,834 members
Articles / Desktop Programming / WPF
Article

WPF Arrow and Custom Shapes

Rate me:
Please Sign up or sign in to vote.
4.42/5 (15 votes)
26 Jan 2008CPOL2 min read 162.2K   3.8K   35   18
This article demonstrates how to create an Arrow shape in WPF, and provides guidelines for creating custom shapes

Introduction

WPF is the best UI Framework ever. It provides us with a large arsenal of vector graphic types such as Line, Ellipse, Path and others. Sometimes we need shapes which are not provided in the WPF arsenal (such an Arrow), and with all due respect to the Path shape, which can be used to create any type of 2D shape, we do not want to recalculate each point every time. This is a good reason and opportunity to create a custom shape.

Background

WPF provides two kinds of vector types: Shapes and Geometries.

Shape is any type that derives from the Shape base class. It provides Fill, Stroke and other properties for coloring, and is actually a FrameworkElement. Thus we can place shapes inside Panels, we can register shapes routed events and do anything related to FrameworkElement. (MSDN)

Geometry is any type that derives from the Geometry base type. It provides properties for describing any type of 2D geometry. A geometry is actually a Freezable type, thus can be frozen. A frozen object provides better performance by not notifying changes, and can be safely accessed by other threads. Geometry is not Visual, hence should be painted by other types such as Path. (MSDN)

Using the Code

Now that we have a little background, and we know what the differences between a Geometry and Shape are, we can create our shape based on one of these two types. Correct?

Well, surprisingly we can't base our custom shape on the Geometry type, since its one and only default constructor is marked as internal. Shame on you Microsoft.

Don't worry! We still have an option to base our custom shape on the Shape base class.

Now, let’s say that we want to create an Arrow shape. An arrow is actually a kind of line, so let’s derive our custom type from the WPF Line type which has X1, Y1, X2 and Y2 properties.

Ooopps... Line is sealed! (Shame on you twice).

Never mind, let's derive directly from the Shape base class, and add X1, Y1, X2, Y2 and two additional properties for defining the arrow's head width and height.

Arrow.jpg

Our code should end up with something like this:

C#
public sealed class Arrow : Shape
{
    public static readonly DependencyProperty X1Property = ...;
    public static readonly DependencyProperty Y1Property = ...;
    public static readonly DependencyProperty HeadHeightProperty = ...;
    ...

    [TypeConverter(typeof(LengthConverter))]
    public double X1
    {
        get { return (double)base.GetValue(X1Property); }
        set { base.SetValue(X1Property, value); }
    }

    [TypeConverter(typeof(LengthConverter))]
    public double Y1
    {
        get { return (double)base.GetValue(Y1Property); }
        set { base.SetValue(Y1Property, value); }
    }

    [TypeConverter(typeof(LengthConverter))]
    public double HeadHeight
    {
        get { return (double)base.GetValue(HeadHeightProperty); }
        set { base.SetValue(HeadHeightProperty, value); }
    }
    ...

    protected override Geometry DefiningGeometry
    {
        get
        {
            // Create a StreamGeometry for describing the shape
            StreamGeometry geometry = new StreamGeometry();
            geometry.FillRule = FillRule.EvenOdd;

            using (StreamGeometryContext context = geometry.Open())
            {
                InternalDrawArrowGeometry(context);
            }

            // Freeze the geometry for performance benefits
            geometry.Freeze();

            return geometry;
        }
    }

    /// <summary>
    /// Draws an Arrow
    /// </summary>
    private void InternalDrawArrowGeometry(StreamGeometryContext context)
    {
        double theta = Math.Atan2(Y1 - Y2, X1 - X2);
        double sint = Math.Sin(theta);
        double cost = Math.Cos(theta);

        Point pt1 = new Point(X1, this.Y1);
        Point pt2 = new Point(X2, this.Y2);

        Point pt3 = new Point(
            X2 + (HeadWidth * cost - HeadHeight * sint),
            Y2 + (HeadWidth * sint + HeadHeight * cost));

        Point pt4 = new Point(
            X2 + (HeadWidth * cost + HeadHeight * sint),
            Y2 - (HeadHeight * cost - HeadWidth * sint));

        context.BeginFigure(pt1, true, false);
        context.LineTo(pt2, true, true);
        context.LineTo(pt3, true, true);
        context.LineTo(pt2, true, true);
        context.LineTo(pt4, true, true);
    }
}

As you can see, it is very easy to implement a custom shape, thanks to the great work in the Shape base class. All we have to do is derive our custom shape type from Shape, and override the DefiningGeometry property. This property should return a Geometry of any type.

Points of Interest

My solution creates and returns a new frozen geometry on each call. Alternatively, you can cache a non frozen geometry by holding it as a field in the custom Shape class.

Final Words

Although custom shapes are very simple to implement, you can open Reflector or use the latest Microsoft .NET Framework code release to learn more about how the WPF team implemented WPF shapes.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect CodeValue
Israel Israel
Tomer Shamam is a Software Architect and a UI Expert at CodeValue, the home of software experts, based in Israel (http://codevalue.net). Tomer is a speaker in Microsoft conferences and user groups, and in-house courses. Tomer has years of experience in software development, he holds a B.A degree in computer science, and his writings appear regularly in the Israeli MSDN Pulse, and other popular developer web sites such as CodePlex and The Code Project. About his thoughts and ideas you can read in his blog (http://blogs.microsoft.co.il/blogs/tomershamam).

Comments and Discussions

 
GeneralIncomplete Code and No Download Pin
Ray Hayes23-Jan-08 5:36
Ray Hayes23-Jan-08 5:36 
AnswerRe: Incomplete Code and No Download Pin
Tomer Shamam23-Jan-08 5:41
Tomer Shamam23-Jan-08 5:41 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.