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](slug:telerik.reporting.radialgaugeneedle) class. The previous NeedleLength, NeedlePointRadius, NeedleStyle, and NeedleThicknessproperties onRadialGauge` 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