Global Settings

This article describes the global settings applied in the Diagramming Framework.

The Diagramming Framework provides a list of constants that are applied throughout the different diagramming tools and items. You can change their default values to customize the global settings in the RadDiagram elements. The constants can be accessed via the DiagramConstants class.

Example 1: Setting diagram constants

DiagramConstants.MinimumZoom = 0.5; 
DiagramConstants.MaximumZoom = 4; 
DiagramConstants.StartDragDelta = 10; 
  • BezierAutoOffset: Gets or sets the default offset between the Bezier handle points and the endpoints of the connection when the handle points coordinates are automatically calculated according to a connector's position. The default value of this constant is 30px. Read More.

  • ConnectionCornerRadius: Gets or sets the connection corner radius that is used to create a rounded polyline connection. The default value of this constant is 10px. Read More.

  • ConnectorActivationRadius: Gets or sets the distance, within which the shape's connectors are visible. Its default value is 15px. Read more about the RadDiagramShape connectors in the Shapes tutorial.

  • ConnectorHitTestRadius: Gets or sets the radius around the connector where connection can attach. The default value of this constant is 5px. Read more about the RadDiagramShape connectors in the Shapes tutorial.

  • ContainerMargin: Gets or sets the margin that is applied around the Items collection of the RadDiagramContainerShape. The default value of this constant is 10px. Read More.

  • CrossingRadius: Gets or sets the radius of the connection bridge or gap. This feature is further described in the Connections tutorial. The default value of this constant is 5px.

  • InflatedRouterMinimumMargin: Gets or sets the margin around the shapes, which the Telerik.Windows.Diagrams.Core.InflatedRectRouter inflates the shapes with. This constant is used in the routing algorithm to make sure that a connection doesn't collide with a shape. This is why we don't recommend setting the value of this constant to 0px. The default value of this constant is 20px.

    This property is obsolete. Use RouterInflationValue instead.

  • RouterInflationValue: Gets or sets the distance around the shapes which the router inflates the shapes with, if implemented. This property is used by the InflatedRectRouted and AStarRouter.

  • ZoomScaleFactor: Gets or sets the default zoom factor that is used as a multiplier or divider to produce the next step in a zoom operation. The default value of this constant is 1.2. Read more about zooming in the Pan and Zoom tutorial.

  • MaximumZoom: Gets or sets the maximum zoom level. The default value of this constant is 5. Read more about zooming in the Pan and Zoom tutorial.

  • MinimumZoom: Gets or sets the minimum zoom level. The default value of this constant is 0.5. Read more about zooming in the Pan and Zoom tutorial.

  • RotationAngleSnap: Gets or sets the snapping angle when rotating items. The default value of this constant is 5 degrees. Read more about rotation in the Rotation tutorial.

  • RotationHitTestRadius: Gets or sets the radius around the rotation thumb where a click operation activates the thumb. The default value of this constant is 7px. Read more about rotation in the Rotation tutorial.

  • RoutingGridSize: Gets or sets the routing grid cell size. The value of this constant is used in the algorithm used to layout the RadDiagramConnections. The default value of this constant is 40px.

  • SelectionHitTestRadius: Gets or sets the radius of the area around each item which is considered selectable. The default value of this constant is 10px.

  • SelectionRectInflationValue: Gets of sets the margin around the selected shapes. The default value of this constant is 7px.

  • StartDragDelta: Gets or sets the minimum distance that a mouse move operation has to cover to start a drag action. The default value of this constant is 4px.

  • MinimumShapeDistanceOnConnectionManipulationSnap: Gets or sets a double value that determines he minimum distance from a connection to a given shape so that snapping occurs.

  • MinimumAdornerSize: Gets or sets a double value that determines the minimum size of the diagram items adorner.

  • MinimumShapeSize: Gets or sets a double value that determines the minimum size of the diagram shapes.

We recommend to use matching values for the MinimumShapeSize and MinimumAdornerSize properties. Otherwise, the adorner won't match the shape's size when its minimum value is reached.

In this article