Class
DiagramConnectionDescriptor

Configures a connection (line or arrow) between shapes in the Diagram. Connections visually represent relationships and can include customizable styling, caps, routing, and interactive behaviors. Use this descriptor to define connection appearance, endpoints, labels, and user interaction settings.

Definition

Namespace:Telerik.Blazor.Components

Assembly:Telerik.Blazor.dll

Syntax:

cs-api-definition
public class DiagramConnectionDescriptor : DataVizCollectionItemComponentDescriptor

Inheritance: objectDataVizChildComponentDescriptorDataVizCollectionItemComponentDescriptorDiagramConnectionDescriptor

Constructors

DiagramConnectionDescriptor()

Declaration

cs-api-definition
public DiagramConnectionDescriptor()

Properties

Content

Configures the content (label) displayed on the connection line. Use the DiagramConnectionContentDescriptor to set text, position, font styling, and other label properties. Example: Display "Approved" text on a connection between workflow steps.

Declaration

cs-api-definition
public DiagramConnectionContentDescriptor Content { get; set; }

Property Value

DiagramConnectionContentDescriptor

DataItem

The data item of the shape.

Declaration

cs-api-definition
public object DataItem { get; set; }

Property Value

object

Editable

Controls which aspects of the connection can be edited by users through drag-and-drop interactions. Configure using DiagramConnectionEditableDescriptor to enable or disable editing of connection endpoints, routing points, and other properties.

Declaration

cs-api-definition
public DiagramConnectionEditableDescriptor Editable { get; set; }

Property Value

DiagramConnectionEditableDescriptor

EndCap

Defines the visual appearance of the arrow or cap at the end (target) of the connection. Use DiagramConnectionEndCapDescriptor to set the cap type (arrow, circle, none), fill color, stroke, and anchor position. Common usage: Set to ArrowEnd to show directional flow.

Declaration

cs-api-definition
public DiagramConnectionEndCapDescriptor EndCap { get; set; }

Property Value

DiagramConnectionEndCapDescriptor

From

Specifies the exact starting coordinates or source shape details for the connection origin. Use DiagramConnectionFromDescriptor to set X/Y coordinates when connecting to a specific point rather than a shape. Typically used with FromId or FromConnector for shape-based connections.

Declaration

cs-api-definition
public DiagramConnectionFromDescriptor From { get; set; }

Property Value

DiagramConnectionFromDescriptor

FromConnector

Specifies which connector point on the source shape the connection should attach to. Available options: Top, Bottom, Left, Right, or Auto. Requires FromId to be set to identify the source shape. Example: Set to Bottom to connect from the bottom of the source shape.

Declaration

cs-api-definition
public DiagramConnectionsFromConnector? FromConnector { get; set; }

Property Value

DiagramConnectionsFromConnector?

FromId

Identifies the source shape by its unique ID from which this connection originates. Must match the Id of an existing shape in the diagram. Works together with FromConnector to specify the exact attachment point on the shape. Example: Set to "shape-1" to connect from the shape with Id="shape-1".

Declaration

cs-api-definition
public string FromId { get; set; }

Property Value

string

Hover

Configures the visual appearance of the connection when users hover over it with the mouse. Use DiagramConnectionHoverDescriptor to define hover-specific stroke color, width, and dash patterns. Provides visual feedback to users indicating the connection is interactive.

Declaration

cs-api-definition
public DiagramConnectionHoverDescriptor Hover { get; set; }

Property Value

DiagramConnectionHoverDescriptor

Id

Sets a unique identifier for this connection, used to distinguish it from other connections in the diagram. Required when you need to programmatically reference, update, or remove specific connections. Should be unique across all connections in the diagram. Example: Set to "workflow-approval-connection" for easy identification in code.

Declaration

cs-api-definition
public string Id { get; set; }

Property Value

string

Points

Defines intermediate waypoints that control the path routing of the connection between source and target. Use DiagramConnectionPointDescriptor to add custom routing points with X/Y coordinates. Allows creating non-straight connections that route around obstacles or follow specific paths.

Declaration

cs-api-definition
public List<DiagramConnectionPointDescriptor> Points { get; set; }

Property Value

List<DiagramConnectionPointDescriptor>

Selection

Configures the visual appearance of the connection when selected by users. Use DiagramConnectionSelectionDescriptor to customize selection handles, colors, and interaction behavior. Selection state is activated when users click on the connection.

Declaration

cs-api-definition
public DiagramConnectionSelectionDescriptor Selection { get; set; }

Property Value

DiagramConnectionSelectionDescriptor

StartCap

Defines the visual appearance of the arrow or cap at the start (source) of the connection. Use DiagramConnectionStartCapDescriptor to set the cap type (arrow, circle, none), fill color, stroke, and anchor position. Common usage: Set to ArrowStart for bi-directional flow visualization.

Declaration

cs-api-definition
public DiagramConnectionStartCapDescriptor StartCap { get; set; }

Property Value

DiagramConnectionStartCapDescriptor

Stroke

Configures the line style and appearance of the connection path. Use DiagramConnectionStrokeDescriptor to set line color, width, and dash pattern (solid, dashed, dotted). Example: Set color to "#0078D4" and width to 2 for a prominent blue connection line.

Declaration

cs-api-definition
public DiagramConnectionStrokeDescriptor Stroke { get; set; }

Property Value

DiagramConnectionStrokeDescriptor

To

Specifies the exact ending coordinates or target shape details for the connection destination. Use DiagramConnectionToDescriptor to set X/Y coordinates when connecting to a specific point rather than a shape. Typically used with ToId or ToConnector for shape-based connections.

Declaration

cs-api-definition
public DiagramConnectionToDescriptor To { get; set; }

Property Value

DiagramConnectionToDescriptor

ToConnector

Specifies which connector point on the target shape the connection should attach to. Available options: Top, Bottom, Left, Right, or Auto. Requires ToId to be set to identify the target shape. Example: Set to Top to connect to the top of the destination shape.

Declaration

cs-api-definition
public DiagramConnectionsToConnector? ToConnector { get; set; }

Property Value

DiagramConnectionsToConnector?

ToId

Identifies the target shape by its unique ID where this connection terminates. Must match the Id of an existing shape in the diagram. Works together with ToConnector to specify the exact attachment point on the destination shape. Example: Set to "shape-2" to connect to the shape with Id="shape-2".

Declaration

cs-api-definition
public string ToId { get; set; }

Property Value

string

Tooltip

Configures tooltip content that appears when users hover over the connection. Use DiagramConnectionTooltipDescriptor to customize tooltip text, styling, and positioning. Helpful for displaying additional information like connection metadata, weights, or descriptions.

Declaration

cs-api-definition
public DiagramConnectionTooltipDescriptor Tooltip { get; set; }

Property Value

DiagramConnectionTooltipDescriptor

Type

Controls the routing algorithm used to draw the connection path between shapes. Polyline creates straight lines with right angles (default) - best for structured diagrams and flowcharts. Cascading creates smooth curved connections - best for organic layouts and data flow diagrams. The routing algorithm automatically adjusts the path when shapes are moved or resized.

Declaration

cs-api-definition
public DiagramConnectionType? Type { get; set; }

Property Value

DiagramConnectionType?