[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Collapse]Office File API
  Demo Application
  Redistribution and Deployment
 [Collapse]Spreadsheet Document API
   Product Structure
   Getting Started
  [Expand]Spreadsheet Document
   Supported Formats
  [Expand]Cell Basics
  [Expand]Formulas
   Defined Names
   Data Binding
  [Expand]Pivot Tables
  [Expand]Charts and Graphics
  [Expand]Mail Merge
  [Collapse]Examples
   [Expand]Files
   [Expand]Workbooks
   [Expand]Worksheets
   [Expand]Rows and Columns
   [Expand]Cells
   [Expand]Formulas
   [Expand]Import and Export Data
   [Expand]Data Binding
    Sorting
   [Expand]Mail Merge
    Search
   [Collapse]Shapes
     How to: Create a Shape
     How to: Create a Shape Group
     How to: Create a Shape Connector
     How to: Add Text to a Shape
     How to: Change Shape's Fill and Outline Color
     How to: Remove a Shape
   [Expand]Charts
   [Expand]Sparklines
   [Expand]Formatting Cells
   [Expand]Conditional Formatting
   [Expand]Group Data
   [Expand]Filter Data
   [Expand]Tables
   [Expand]Pivot Tables
   [Expand]Printing
   [Expand]Pictures
   [Expand]Protection
 [Expand]Word Processing Document API
 [Expand]PDF Document API
 [Expand]Excel Export Library
 [Expand]Snap Report API
 [Expand]Zip Compression and Archive API
 [Expand]Barcode Generation API
 [Expand]Unit Conversion API
 [Expand]API Reference
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

How to: Create a Shape Connector

You can connect two shapes with a connector. This example illustrates how to create a shape connector, modify it, and attach both its ends to shapes.

Expanded Create a Shape Connector

Call the ShapeCollection.AddConnector method to create an unbound shape connector.

Expanded Modify a Shape Connector

The table below lists an API used to change the connector's appearance.

Task

API

Change the connector's type

ConnectorFormat.ConnectorType

Change the connector's color and thickness

ShapeFormatBase.Outline

ShapeOutline.Width

Specify arrowhead options for the connector's start

ArrowSettings.StartArrowheadType

ArrowSettings.StartArrowheadWidth

ArrowSettings.StartArrowheadLength

Specify arrowhead options for the connector's end

ArrowSettings.EndArrowheadType

ArrowSettings.EndArrowheadWidth

ArrowSettings.EndArrowheadLength

The code sample below shows how to use these members to make the connector look as it does on the following image.

Expanded Attach Shapes to the Connector

The following methods allow you to link shapes to a connector.

Check the ShapeGeometry.ConnectionSiteCount property to retrieve the shape's connection sites' number. The sites' index order is different for each shape. Generally, the index begins with the top side (0) and grows counterclockwise, as shown below.

As for the 3-D shapes, the connection sites' index changes as follows.

The code sample shows how to attach shapes to the connector. The connector is bound to the third site of each shape.

Tip

Call the ConnectorFormat.DisconnectStartPoint or ConnectorFormat.DisconnectEndPoint method to detach the connector from shapes.

Is this topic helpful?​​​​​​​