New to Telerik UI for WinFormsStart a free 30-day trial

IConnection

Interface

Represents a connection.

Definition

Properties

Gets or sets the Bezier tension.

C#
double BezierTension { get; set; }
Remarks:

A value or zero turns the Bezier connection into a straight line, a value of one and above increase the sharpness of the Bezier curve.

Gets the connection points.

C#
IList<Point> ConnectionPoints { get; }
Remarks:

The positions are absolute coordinates with respect to the canvas.

Gets or sets the type of the connection.

C#
ConnectionType ConnectionType { get; set; }

Gets or sets the position of where this connection ends.

C#
Point EndPoint { get; set; }

Gets the geometry of the connection.

C#
Geometry Geometry { get; }

Gets or sets a value indicating whether the default Bezier handles have been altered or an intermediate point have been added/removed.

C#
bool IsModified { get; set; }
Remarks:
  • This property is set to true as soon as one of the Bezier handles has been manually modified or the intermediate points have changed. If this property is true the connection routing and the automatic bezier handles are halted. You re-enable this functionality by re-setting this property to false.

Gets the manipulation points (the adorning elements of the connection which allow you to alter an intermediate connection point).

C#
IList<IConnectionEditPoint> ManipulationPoints { get; }

Gets or sets whether this connection will be automatically routed.

C#
bool Route { get; set; }
Remarks:

Setting this property effects only Spline and Polyline connections.

Gets or sets the source shape of this connection.

C#
IShape Source { get; set; }

Gets or sets the size of the source cap (source decorator or arrow head).

C#
SizeF SourceCapSize { get; set; }

Gets or sets the type of the source cap.

C#
CapType SourceCapType { get; set; }
Property Value:

The type of the source cap.

Gets or sets the position of the source connector.

C#
string SourceConnectorPosition { get; set; }
Remarks:

By default this is one of the standard position names defined in ConnectorPosition, but if one or more custom connectors are defined on the source shape this can be a custom connector name.

Gets the actual source connector of this connection if the connector is dynamically assigned (Auto).

C#
IConnector SourceConnectorResult { get; }

Gets or sets the position of where this connection starts.

C#
Point StartPoint { get; set; }

Gets or sets the target shape of this connection.

C#
IShape Target { get; set; }

Gets or sets the size of the target cap (target decorator or arrow head).

C#
SizeF TargetCapSize { get; set; }

Gets or sets the type of the target cap (target decorator or arrow head).

C#
CapType TargetCapType { get; set; }

Gets or sets the target connector position.

C#
string TargetConnectorPosition { get; set; }
Remarks:

By default this is one of the standard position names defined in ConnectorPosition, but if one or more custom connectors are defined on the target shape this can be a custom connector name.

Gets the actual target connector of this connection if the connector is dynamically assigned (Auto).

C#
IConnector TargetConnectorResult { get; }

Gets or sets whether the connection will choose free (not yet used) connector in the source / target shape when the source / target connector position is Auto.

C#
bool UseFreeConnectors { get; set; }

Methods

Adds an intermediate connection point.

C#
void AddConnectionPoint(Point point)
Parameters:pointPoint

The (absolute canvas) position at which the new connection point should be added.

Attaches the connection to specific source and target.

C#
void Attach(IConnector source = null, IConnector target = null)
Parameters:sourceIConnector

The source connector to attach to.

targetIConnector

The target connector to attach to.

Returns the information related to the crossing of this connection with other connections.

C#
CrossingsData GetCrossings()
Returns:

CrossingsData

Inserts the connection point after the specific index.

C#
void InsertConnectionPoint(Point point, int after)
Parameters:pointPoint

The point to add.

afterint

The index after which it will be positioned.

Remarks:

The zero-position corresponds to the source points, the first position is the first intermediate point and the last index is the target point.

Updates this connection.

C#
void Update(bool isManipulating = false)
Parameters:isManipulatingbool

Should be set to true if any of the manipulation services (for instance RotationService, DraggingService) is active as a result of a user action.

Updates the deferred geometry.

C#
void UpdateDeferredGeometry(Point startPoint, Point endPoint, Point[] middlePoints)
Parameters:startPointPoint

The start point.

endPointPoint

The end point.

middlePointsPoint[]

The middle points.

Events

Occurs when a manipulation point (an adorner of the connection which allows you to alter an intermediate connection point) is activated.

C#
event EventHandler<ManipulationPointActivatedEventArgs<IConnectionEditPoint>> ManipulationPointActivated

Extension Methods