Back to Devexpress

Shape.ConnectorFormat Property

officefileapi-devexpress-dot-spreadsheet-dot-shape-d43cef08.md

latest4.0 KB
Original Source

Shape.ConnectorFormat Property

Provides access to the shape connector settings.

Namespace : DevExpress.Spreadsheet

Assembly : DevExpress.Spreadsheet.v25.2.Core.dll

NuGet Package : DevExpress.Spreadsheet.Core

Declaration

csharp
ConnectorFormat ConnectorFormat { get; }
vb
ReadOnly Property ConnectorFormat As ConnectorFormat

Property Value

TypeDescription
ConnectorFormat

A ConnectorFormat object containing the shape connector options.

|

Remarks

Use the ConnectorFormat options to modify a shape connector: change its type (ConnectorFormat.ConnectorType), outline color (ShapeFormatBase.Outline), create arrowheads (ConnectorFormat.Arrows), and bind the connector to shapes (ConnectorFormat.ConnectStartPoint , ConnectorFormat.ConnectEndPoint).

Example

The code sample below shows how to insert a shape connector, provide it with arrows, change the outline color and attach it to shapes. Both ends are connected to the third connection site of each shape.

csharp
// Insert a shape connector.
Shape shapeConnector = worksheet.Shapes.AddConnector(ConnectorType.Curved, 10, 10, 100, 100);
// Adjust the connector's outline.
shapeConnector.Outline.SetSolidFill(Color.Black);
shapeConnector.Outline.Width = 2.5;

// Convert the connector's ends into arrows.
ConnectorFormat connectorFormat = shapeConnector.ConnectorFormat;
connectorFormat.Arrows.StartArrowheadType = ArrowheadType.Stealth;
connectorFormat.Arrows.StartArrowheadWidth = ArrowheadSize.Large;
connectorFormat.Arrows.StartArrowheadLength = ArrowheadSize.Large;

connectorFormat.Arrows.EndArrowheadType = ArrowheadType.Stealth;
connectorFormat.Arrows.EndArrowheadWidth = ArrowheadSize.Large;
connectorFormat.Arrows.EndArrowheadLength = ArrowheadSize.Large;

// Bind the connector to two shapes.
connectorFormat.ConnectStartPoint(shape1, 3);
connectorFormat.ConnectEndPoint(shape2, 3);
vb
' Insert a shape connector.
Dim shapeConnector As Shape = worksheet.Shapes.AddConnector(ConnectorType.Curved, 10, 10, 100, 100)
' Adjust the connector's outline.
shapeConnector.Outline.SetSolidFill(Color.Black)
shapeConnector.Outline.Width = 2.5

' Convert the connector's ends into arrows.
Dim connectorFormat As ConnectorFormat = shapeConnector.ConnectorFormat
connectorFormat.Arrows.StartArrowheadType = ArrowheadType.Stealth
connectorFormat.Arrows.StartArrowheadWidth = ArrowheadSize.Large
connectorFormat.Arrows.StartArrowheadLength = ArrowheadSize.Large

connectorFormat.Arrows.EndArrowheadType = ArrowheadType.Stealth
connectorFormat.Arrows.EndArrowheadWidth = ArrowheadSize.Large
connectorFormat.Arrows.EndArrowheadLength = ArrowheadSize.Large

' Bind the connector to two shapes.
connectorFormat.ConnectStartPoint(shape1, 3)
connectorFormat.ConnectEndPoint(shape2, 3)

See Also

Shape Interface

Shape Members

DevExpress.Spreadsheet Namespace