We use cookies to give you the best experience on our website. If you continue to browse, then you agree to our privacy policy and cookie policy. Image for the cookie policy date
Unfortunately, activation email could not send to your email. Please try again.
Syncfusion Feedback

How do I extend the Link types present in Essential Diagram?

Platform: WinForms |
Control: Diagram

How do I extend the Link types present in Essential Diagram?

To create a new Link class or to customize the drawing for an existing link type, implement a subclass of the Syncfusion.Windows.Forms.Diagram.Link class with an appropriate override of the Link.CreateLinkShape(Link.Shapes shapeType, PointF[] pts) method. The CreateLinkShape method is called by the Link constructor and it is up to your override to suitably interpret the method parameters and returns a valid implementation of the Syncfusion.Windows.Forms.Diagram.IPoints interface. A sample override is shown below:


// A subclass of the Syncfusion.Windows.Forms.Diagram.Link class
public class CustomLink : Syncfusion.Windows.Forms.Diagram.Link
// Override the Link.CreateLinkShape method to create a link for the specified type 
// and with the given points
protected override IPoints CreateLinkShape(Link.Shapes shapeType, PointF[] pts)
Shape linkShape = null;
  if(shapeType == Link.Shapes.OrthogonalLine)
    OrthogonalLine orthogonalLine = new OrthogonalLine();
    orthogonalLine.AutomaticHeadings = true;
    linkShape = orthogonalLine;
   if(linkShape != null)
   return linkShape;


Now all that is required to use this Link type is to provide to the LinkTool a LinkFactory delegate that instantiates this newly defined Link type when the tool is activated. A sample implementation is shown below:


// Create a Link tool for the custom link type
LinkTool customLinkTool = new LinkTool("CustomLinkTool");
customLinkTool.LinkFactory = new LinkFactory(this.CreateCustomLink);
// Register this tool with the Diagram Controller
// LinkFactory delegate for instantiating the CustomLink
protected Link CreateCustomLink(PointF[] pts)
CustomLink mylink = new CustomLink(Link.Shapes.OrthogonalLine, pts);
return mylink;


2X faster development

The ultimate WinForms UI toolkit to boost your development speed.
You must log in to leave a comment

Please sign in to access our KB

This page will automatically be redirected to the sign-in page in 10 seconds.

Up arrow icon

Warning Icon You are using an outdated version of Internet Explorer that may not display all features of this and other websites. Upgrade to Internet Explorer 8 or newer for a better experience.Close Icon

Live Chat Icon For mobile