Class RadDiagramConnection
The RadDiagramConnection is a special ContentControl that serves as a connection between zero, one or two shapes.
Inherited Members
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Diagrams.dll
Syntax
[Themable]
[TelerikToolboxCategory("Diagram")]
public class RadDiagramConnection : RadDiagramItem, IConnection, IDiagramItem, ISerializable, ISupportMouseOver, IPropertyChanged, IGroupable, ISupportManipulation, ISupportVirtualization, IContainerChild, ICollapsible, IThemableConstructors
RadDiagramConnection()
Initializes a new instance of the Rad
Declaration
public RadDiagramConnection()Fields
BezierTensionProperty
Identifies the BezierTensionProperty dependency property.
Declaration
public static readonly DependencyProperty BezierTensionPropertyField Value
|
System.
|
ConnectionTypeProperty
Identifies the ConnectionType dependency property.
Declaration
public static readonly DependencyProperty ConnectionTypePropertyField Value
|
System.
|
ConnectorCenterPointProperty
Identifies the ConnectorCenterPoint.
Declaration
public static readonly DependencyProperty ConnectorCenterPointPropertyField Value
|
System.
|
EndPointProperty
Identifies the EndPoint dependency property.
Declaration
public static readonly DependencyProperty EndPointPropertyField Value
|
System.
|
IsAutoUpdateSuppressedProperty
Identifies the IsAutoUpdateSuppressedProperty.
Declaration
public static readonly DependencyProperty IsAutoUpdateSuppressedPropertyField Value
|
System.
|
RouteProperty
Identifies the RouteProperty property.
Declaration
public static readonly DependencyProperty RoutePropertyField Value
|
System.
|
SourceCapSizeProperty
Identifies the SourceCapSize dependency property.
Declaration
public static readonly DependencyProperty SourceCapSizePropertyField Value
|
System.
|
SourceCapTypeProperty
Identifies the SourceCapType dependency property.
Declaration
public static readonly DependencyProperty SourceCapTypePropertyField Value
|
System.
|
SourceConnectorPositionProperty
Identifies the SourceConnectorPosition dependency property.
Declaration
public static readonly DependencyProperty SourceConnectorPositionPropertyField Value
|
System.
|
SourceProperty
Identifies the Source dependency property.
Declaration
public static readonly DependencyProperty SourcePropertyField Value
|
System.
|
StartPointProperty
Identifies the StartPoint dependency property.
Declaration
public static readonly DependencyProperty StartPointPropertyField Value
|
System.
|
TargetCapSizeProperty
Identifies the TargetCapSize dependency property.
Declaration
public static readonly DependencyProperty TargetCapSizePropertyField Value
|
System.
|
TargetCapTypeProperty
Identifies the TargetCapType dependency property.
Declaration
public static readonly DependencyProperty TargetCapTypePropertyField Value
|
System.
|
TargetConnectorPositionProperty
Identifies the TargetConnectorPosition dependency property.
Declaration
public static readonly DependencyProperty TargetConnectorPositionPropertyField Value
|
System.
|
TargetProperty
Identifies the TargetProperty dependency property.
Declaration
public static readonly DependencyProperty TargetPropertyField Value
|
System.
|
UseFreeConnectorsProperty
Identifies the Use
Declaration
public static readonly DependencyProperty UseFreeConnectorsPropertyField Value
|
System.
|
Properties
Adorner
The connection adorner which helps manipulating this connection.
Declaration
public ConnectionManipulationAdorner Adorner { get; set; }Property Value
BezierTension
Gets or sets the Bezier tension.
Declaration
public double BezierTension { get; set; }Property Value
|
System. 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. |
Implements
Bounds
Gets the bounds.
Declaration
public override Rect Bounds { get; }Property Value
|
System. The bounds. |
Overrides
Implements
ConnectionPoints
Gets the connection points of the connection.
Declaration
public IList<Point> ConnectionPoints { get; }Property Value
|
System.
|
Implements
Remarks
The positions are absolute coordinates with respect to the canvas.
ConnectionType
Gets or sets the type of the connection.
Declaration
public ConnectionType ConnectionType { get; set; }Property Value
|
Connection The type of the connection. |
Implements
EndPoint
Gets or sets the position of where this connection ends.
Declaration
public Point EndPoint { get; set; }Property Value
|
System.
|
Implements
Geometry
Gets the geometry of the connection.
Declaration
public Geometry Geometry { get; }Property Value
|
System.
|
Implements
IsModified
Gets or sets a value indicating whether the connection has been modified.
Declaration
public bool IsModified { get; set; }Property Value
|
System.
|
Implements
Remarks
ManipulationPoints
Gets the manipulation points, which are equal to the adorner's connection editing points.
Declaration
public IList<IConnectionEditPoint> ManipulationPoints { get; }Property Value
|
System.
|
Implements
Route
Gets or sets whether this connection will be automatically routed.
Declaration
public bool Route { get; set; }Property Value
|
System.
|
Implements
Remarks
SegmentCount
Gets the number of segments this connection has.
Declaration
public int SegmentCount { get; }Property Value
|
System.
|
Source
Gets or sets the source.
Declaration
public IShape Source { get; set; }Property Value
|
IShape
The source. |
Implements
SourceCapSize
Gets or sets the size of the source cap.
Declaration
public Size SourceCapSize { get; set; }Property Value
|
System. The size of the source cap. |
Implements
SourceCapType
Gets or sets the type of the source cap.
Declaration
public CapType SourceCapType { get; set; }Property Value
|
Cap The type of the source cap. |
Implements
SourceConnectorPosition
Gets or sets the source connector position.
Declaration
public string SourceConnectorPosition { get; set; }Property Value
|
System. The source connector position. |
Implements
SourceConnectorResult
Gets the source connector result.
Declaration
public IConnector SourceConnectorResult { get; }Property Value
Implements
StartPoint
Gets or sets the position of where this connection starts.
Declaration
public Point StartPoint { get; set; }Property Value
|
System.
|
Implements
Target
Gets or sets the target.
Declaration
public IShape Target { get; set; }Property Value
|
IShape
The target. |
Implements
TargetCapSize
Gets or sets the size of the target cap.
Declaration
public Size TargetCapSize { get; set; }Property Value
|
System. The size of the target cap. |
Implements
TargetCapType
Gets or sets the type of the target cap.
Declaration
public CapType TargetCapType { get; set; }Property Value
|
Cap The type of the target cap. |
Implements
TargetConnectorPosition
Gets or sets the target connector position.
Declaration
public string TargetConnectorPosition { get; set; }Property Value
|
System. The target connector position. |
Implements
TargetConnectorResult
Gets the target connector result.
Declaration
public IConnector TargetConnectorResult { get; }Property Value
Implements
UseFreeConnectors
Gets or sets whether this connection will choose free connectors when attaching to shape with Source or TargetConnectorPosition Auto.
Declaration
public bool UseFreeConnectors { get; set; }Property Value
|
System.
|
Implements
Methods
AddConnectionPoint(Point)
Adds an intermediate connection point.
Declaration
public void AddConnectionPoint(Point point)Parameters
|
System. The (absolute canvas) position at which the new connection point should be added. |
Implements
Attach(IConnector, IConnector)
Attaches the connection to specific source and target.
Declaration
public void Attach(IConnector source = null, IConnector target = null)Parameters
|
IConnector
source
The source. |
|
IConnector
target
The target. |
Implements
ConnectionTypeChanged(ConnectionType, ConnectionType)
Invoked on connection type changed.
Declaration
protected virtual void ConnectionTypeChanged(ConnectionType newValue, ConnectionType oldValue)Parameters
|
Connection The new value. |
|
Connection The old value. |
CreateGeometry(BridgeType, Boolean)
Creates the connection's geometry.
Declaration
protected virtual Geometry CreateGeometry(BridgeType bridgeType, bool roundedCorners)Parameters
|
Bridge
|
|
System.
|
Returns
|
System.
|
CreateSourceCapGeometry(Point, Point, ref Point)
Creates the source cap geometry.
Declaration
protected virtual PathFigure CreateSourceCapGeometry(Point startPoint, Point endPoint, ref Point baseLineStart)Parameters
|
System. The start point. |
|
System. The end point. |
|
System. The new start of the base line. |
Returns
|
System.
|
CreateTargetCapGeometry(Point, Point, ref Point)
Creates the target cap geometry.
Declaration
protected virtual PathFigure CreateTargetCapGeometry(Point startPoint, Point endPoint, ref Point baseLineEnd)Parameters
|
System. The start point. |
|
System. The end point. |
|
System. The new end of the base line. |
Returns
|
System.
|
Deserialize(SerializationInfo)
Deserializes the serialization info in this diagram entity.
Declaration
public override void Deserialize(SerializationInfo info)Parameters
|
Serialization A Serialization |
Overrides
Implements
FetchZConnections(Boolean, Nullable<Rect>)
Returns all connections below or above the current connection that intersect with the given bounds.
Declaration
public IList<IConnection> FetchZConnections(bool below, Nullable<Rect> bounds = null)Parameters
|
System. If set to |
|
System. The bounds. If null the connection's Bounds are used. |
Returns
|
System.
|
GetConnectorCenterPoint(DependencyObject)
Sets the ConnectorCenterPoint.
Declaration
public static Point GetConnectorCenterPoint(DependencyObject obj)Parameters
|
System.
|
Returns
|
System.
|
GetCrossings()
Returns the information related to the crossing of this connection with other connections.
Declaration
public CrossingsData GetCrossings()Returns
Implements
Remarks
GetIsAutoUpdateSuppressed(DependencyObject)
Gets the IsUpdateNeeded.
Declaration
public static bool GetIsAutoUpdateSuppressed(DependencyObject obj)Parameters
|
System.
|
Returns
|
System.
|
InsertConnectionPoint(Point, Int32)
Inserts the connection point after the specific index.
Declaration
public void InsertConnectionPoint(Point point, int after)Parameters
|
System. The point to add. |
|
System. The index after which it will be positioned. |
Implements
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.
OnApplyTemplate()
When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.
Declaration
public override void OnApplyTemplate()Overrides
OnCreateAutomationPeer()
Creates a Telerik.
Declaration
protected override AutomationPeer OnCreateAutomationPeer()Returns
|
System. An instance of the Telerik. |
Overrides
OnEndPointChanged(Point, Point)
Called on end point changed.
Declaration
protected virtual void OnEndPointChanged(Point newValue, Point oldValue)Parameters
|
System. The new value. |
|
System. The old value. |
OnInitialized(EventArgs)
This virtual method in called when IsInitialized is set to true and it raises an Initialized event.
Declaration
protected override void OnInitialized(EventArgs e)Parameters
|
System.
|
OnIsConnectorsManipulationEnabledChanged(Boolean, Boolean)
Called when connectors manipulation changes.
Declaration
protected override void OnIsConnectorsManipulationEnabledChanged(bool newValue, bool oldValue)Parameters
|
System. The new value. |
|
System. The old value. |
Overrides
OnIsInEditModeChanged(Boolean, Boolean)
Called when IsInEditMode changes.
Declaration
protected override void OnIsInEditModeChanged(bool oldIsInEditMode, bool isInEditMode)Parameters
|
System. The old value of the property. |
|
System. The current value of the property. |
Overrides
OnIsSelectedChanged(Boolean, Boolean)
Called when the IsSelected property has changed.
Declaration
protected override void OnIsSelectedChanged(bool oldValue, bool newValue)Parameters
|
System. The old value of the IsSelected property. |
|
System. The new value of the IsSelected property. |
Overrides
OnPositionCoerced(Point)
Called when [position coerced].
Declaration
protected override object OnPositionCoerced(Point position)Parameters
|
System. The new position. |
Returns
|
System.
|
Overrides
OnRouteChanged(Boolean, Boolean)
Called when route changed property change.
Declaration
protected virtual void OnRouteChanged(bool newValue, bool oldValue)Parameters
|
System. The new value. |
|
System. The old value. |
OnSourceChanged()
Called when the source of the Rad
Declaration
protected virtual void OnSourceChanged()OnSourceConnectorPositionChanged(String, String)
Called when on source connector position changed.
Declaration
protected virtual void OnSourceConnectorPositionChanged(string newPosition, string oldPosition)Parameters
|
System. The new position. |
|
System. The old position. |
OnStartPointChanged(Point, Point)
Called on start point changed.
Declaration
protected virtual void OnStartPointChanged(Point newValue, Point oldValue)Parameters
|
System. The new value. |
|
System. The old value. |
OnStrokeThicknessChanged()
Invoked when the StrokeThickness property has changed.
Declaration
protected override void OnStrokeThicknessChanged()Overrides
OnTargetChanged()
Called when the target of the Rad
Declaration
protected virtual void OnTargetChanged()OnTargetConnectorPositionChanged(String, String)
Called when on target connector position changed.
Declaration
protected virtual void OnTargetConnectorPositionChanged(string newPosition, string oldPosition)Parameters
|
System. The new position. |
|
System. The old position. |
OnZIndexChanged(Int32, Int32)
Called when the ZIndex changes.
Declaration
protected override void OnZIndexChanged(int newValue, int oldValue)Parameters
|
System. The new value. |
|
System. The old value. |
Overrides
PositionEditElementOverride()
When overridden, positions the editing element for the Rad
Declaration
protected virtual void PositionEditElementOverride()RefreshIsSelectedInGroup()
Refreshes the is selected in group property.
Declaration
protected override void RefreshIsSelectedInGroup()Overrides
Serialize()
Serializes this instance.
Declaration
public override SerializationInfo Serialize()Returns
Overrides
Implements
SetBezierHandles(Point, Point)
Sets the Bezier handle positions. The coordinates are absolute coordinates with respect to the diagramming surface.
Declaration
public void SetBezierHandles(Point startHandle, Point endHandle)Parameters
|
System. The start handle position. |
|
System. The end handle position. |
Exceptions
|
System. The connection is not a Bezier connection and has no handles. |
SetConnectorCenterPoint(DependencyObject, Point)
Sets the ConnectorCenterPoint.
Declaration
public static void SetConnectorCenterPoint(DependencyObject obj, Point value)Parameters
|
System.
|
|
System.
|
SetIsAutoUpdateSuppressed(DependencyObject, Boolean)
Sets the IsUpdateNeeded.
Declaration
public static void SetIsAutoUpdateSuppressed(DependencyObject obj, bool value)Parameters
|
System.
|
|
System.
|
Update(Boolean)
Updates this instance.
Declaration
protected virtual void Update(bool isManipulating = false)Parameters
|
System.
|
UpdateDeferredGeometry(Point, Point, Point[])
Updates the deferred geometry.
Declaration
protected virtual void UpdateDeferredGeometry(Point start, Point end, Point[] points)Parameters
|
System. The start point of the connection. |
|
System. The end point of the connection. |
|
System. The intermediate connection points. |
UpdateGeometryOverride()
When overridden, provides the geometry for the connection.
Declaration
protected virtual void UpdateGeometryOverride()Remarks
This is called whenever the connection is redrawn.
Events
ManipulationPointActivated
Occurs when a manipulation point of the Rad
Declaration
public event EventHandler<ManipulationPointActivatedEventArgs<IConnectionEditPoint>> ManipulationPointActivatedEvent Type
|
System.
|
Implements
Explicit Interface Implementations
IConnection.Update(Boolean)
Declaration
void IConnection.Update(bool isManipulating)Parameters
|
System.
|
Implements
IConnection.UpdateDeferredGeometry(Point, Point, Point[])
Updates the deferred geometry.
Declaration
void IConnection.UpdateDeferredGeometry(Point start, Point end, Point[] points)Parameters
|
System. The start point of the connection. |
|
System. The end point of the connection. |
|
System. The intermediate connection points. |
Implements
IDiagramItem.get_Content()
Declaration
object IDiagramItem.get_Content()Returns
|
System.
|
Implements
IDiagramItem.get_RenderTransformOrigin()
Declaration
Point IDiagramItem.get_RenderTransformOrigin()Returns
|
System.
|
Implements
IDiagramItem.get_Visibility()
Declaration
Visibility IDiagramItem.get_Visibility()Returns
|
System.
|
Implements
IDiagramItem.set_Content(Object)
Declaration
void IDiagramItem.set_Content(object value)Parameters
|
System.
|
Implements
IDiagramItem.set_IsEnabled(Boolean)
Declaration
void IDiagramItem.set_IsEnabled(bool value)Parameters
|
System.
|
Implements
IDiagramItem.set_RenderTransformOrigin(Point)
Declaration
void IDiagramItem.set_RenderTransformOrigin(Point value)Parameters
|
System.
|
Implements
IDiagramItem.set_Visibility(Visibility)
Declaration
void IDiagramItem.set_Visibility(Visibility value)Parameters
|
System.
|