Version

Configuring the Line Jumps of Diagram Connections (xamDiagram)

Topic Overview

Purpose

This topic explains how to configure the xamDiagram™ rendering behavior when two connections are intersecting.

Required background

The following topics are prerequisites to understanding this topic:

Topic Purpose

This topic provides a conceptual overview of the xamDiagram control and its main features and capabilities.

This topic provides an overview of the connections' configurable aspects of the control.

Configuring Line Jumps

Overview

Sometimes when two connections are intersecting it is hard to follow their route. This is why the control is able to render "line jumps" at the intersection point. There are several line jump types you can chose from. The line jumps are rendered on the top connection and are updated whenever a diagram item changes its bounds (position, size or both).

Note
Note:

If there is no space to render the line jump on the top connection (for example when the two connections are intersecting very close to one of the ends of the top connection) it will be rendered on the bottom connection.

Property settings

The following table maps the desired line jump type to the ConnectionLineJumps property value.

Line Jump Type: Description: Value:

xamDiagram_LineJumps_None.png

No line jumps are rendered and connections are just intersecting each other (default behavior).

xamDiagram_LineJumps_Arc.png

An arc is rendered at the connections' intersection point.

Arc

xamDiagram_LineJumps_Gap.png

A gap is rendered at the connections' intersection point.

Gap

xamDiagram_LineJumps_Square.png

A square is rendered at the connections' intersection point.

Example

The following example demonstrates how to configure the xamDiagram control to render an Arc type line jumps:

<xamDiagram ConnectionLineJumps="Arc">
...
</xamDiagram>

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides an overview of the configurable aspects of the connections of the xamDiagram control.

This topic explains how to configure the connection points of diagram nodes in the xamDiagram control.

This topic covers the alternative approaches used to configure the start and end points of diagram connections in xamDiagram, either by specifying the nodes to connect to or by specifying the coordinates of the connection’s start and end points on the diagram space.

This topic explains how to configure the caps of the diagram connections of the xamDiagram control by either selecting a pre-defined cap or applying a custom cap.