Using the Radial Gauge Report Item

The steps below will demonstrate how to add the Telerik Reporting Radial Gauge report item to reports.

Adding a Radial Gauge to the Report

• Standalone Report Designer - The Gauge item can be inserted from the Insert Ribbon:

  

• Web Report Designer - The Gauge item can be inserted using the Components Tab:

  

• Visual Studio Report Designer - The Gauge item can be inserted from the Visual Studio Toolbox

Properties of the Gauge Report Item

The Gauge Report Item is a data item and as such inherits the properties of the Telerik.Reporting.DataItem class.

Properties specific to the Appearance

• Value - Represents the value of the gauge for the current instance.

• StartAngle - Represents the number of degrees at which the full gauge arc will start.

• SweepAngle - Represents the number of degrees, between 0 and 360, that the scale will sweep in a circle.

• Needle - Represents the RadialGaugeNeedle instance that defines the appearance of the gauge needle.

  • Length - Represents the length of the needle as a percentage ratio to the total gauge radius. When the value is 100, the tip of the needle touches the gauge range.
  • BackLength - Represents the length of the needle's back (the part behind the pivot point) as a percentage ratio to the total gauge radius.
  • PointRadius - Represents the radius of the needle's pivot point as a percentage ratio to the total gauge radius.
  • Thickness - Represents the thickness of the needle as a percentage ratio to the total gauge radius.
  • Style - Represents a Style object used to style the gauge needle.

Starting with Telerik Reporting R2 2023 SP1 (17.1.23.718), the needle settings are exposed in the Needle property through the dedicated RadialGaugeNeedle class. The previous NeedleLength, NeedlePointRadius, NeedleStyle, and NeedleThickness properties on RadialGauge have been removed.

Properties specific to the Presentation

• Labels - The RadialGaugeLabels collection associated with this gauge item.
  • SegmentCount - Represents the total count of labels that will be generated. It is recommended to be equal to the count of the Ticks.
  • FirstVisibleValue - Represents the minimum value for which a label will be rendered. Can be used to restrict the label set. If left empty, all labels will be visible.
  • LastVisibleValue - Represents the maximum value for which a label will be rendered. Can be used to restrict the label set. If left empty, all labels will be visible.
  • Format - Represents the Format instance used to format the label text.
  • Radius - Represents the radius at which the labels will be placed as a percentage ratio to the gauge's radius.
  • Style - Represents a Style instance used to style the label elements.
• Ranges - The RadialGaugeRangeCollection associated with this gauge item. A gauge can have multiple ranges. This is how the Multi-Range gauge is implemented.
  • ArcRadius - Represents the outer radius of the gauge arc.
  • ArcWidth - Represents, as a percentage ratio, the distance between the inner and outer border of the gauge arc.
  • RangeStart - Represents the value at which the given RadialGaugeRange will start.
  • RangeEnd - Represents the value at which the given RadialGaugeRange will end.
  • Style - Represents a Style instance used to style range sectors.
• Ticks - The RadialGaugeTicks collection associated with this gauge item.
  • SegmentCount - Represents the total count of ticks that will be generated. It is recommended to be equal to the count of the Labels.
  • FirstVisibleIndex - Represents the starting tick index from which ticks will be rendered. Tick indexing starts at 0.
  • LastVisibleIndex - Represents the last tick index until which ticks will be rendered. Tick indexing starts at 0.
  • Length - Represents the size of the tick's visual element as a percentage ratio to the gauge radius.
  • Radius - Represents the radius at which the ticks will be placed as a percentage ratio to the gauge's radius. A value higher than 100 would have the engine render the ticks outside the gauge arc.
  • TickType - Represents the type of the shape that will be used for rendering the ticks.
  • Style - Represents a Style instance used to style the ticks.

See Also

• Gauge Report Item Overview
• Linear Gauge Configuration and Usage
• Data Items
• RadialGauge Class API Reference