RadialGauge
Radial Gauge
Definition
Namespace:Telerik.Reporting
Assembly:Telerik.Reporting.dll
Syntax:
[ToolboxBitmap(typeof(RadialGauge), "Resources.GaugeRadial.png")]
public class RadialGauge : DataItem, IToggleVisibilityTarget, IActionTarget, IDataItem, IDataFlow, IDataSourceContainerInheritance: objectReportObjectReportItemBaseReportItemDataItemRadialGauge...
Implements:
Inherited Members
Constructors
The radial gauge report item is used to visualize key performance indicators (KPIs) on a circular or partially circular scale. It displays values using pointers, ranges, labels, and ticks to indicate progress against defined thresholds or targets. Commonly used for dashboards and reports where values need to be interpreted quickly at a glance.
public RadialGauge()Properties
DataSource
object
The data source that the RadialGauge is displaying data for. If not set, the Gauge will use the parent item's data scope.
[TypeConverter(typeof(DataSourceConverter))]
[AIAssistantByRef("/DataSources")]
[AIAssistantRequired(false)]
public override object DataSource { get; set; }An object that functions as a data source.
Overrides:
Telerik Reporting includes dedicated data source components that enable retrieving and feeding all data items from various sources. See all the available data source components at: https://docs.telerik.com/reporting/designing-reports/connecting-to-data/data-source-components/overview
For convenience, all the objects applicable to the DataSource property can be directly assigned to this DataSource property. At runtime, the report engine will wrap them in an ObjectDataSource to resolve the actual data.
Gets the collection of RadialGaugeLabels defined for the current Gauge.
[AIAssistantRequired]
[AIAssistantDescription("The numeric labels rendered along the gauge's scale. Without them the gauge shows no readable values.")]
public RadialGaugeLabelsCollection Labels { get; }The needle defined for the current Gauge.
[AIAssistantRequired]
[AIAssistantDescription("The needle that points at the current Value on the gauge's scale. It is always present, so configure it rather than omitting it.")]
public RadialGaugeNeedle Needle { get; }The collection of RadialGaugeRange defined for the current Gauge.
[AIAssistantRequired]
[AIAssistantDescription("The color ranges (arcs) drawn along the gauge's scale. Each range covers the interval between its Start and End values and is painted with its Style.BackgroundColor. A range is only visible when its InnerRadius and OuterRadius are set, because both default to 0.")]
public RadialGaugeRangeCollection Ranges { get; }StartAngle
double
The current start angle of the full gauge arc in degrees.
public double StartAngle { get; set; }Can be a numeric value.
SweepAngle
double
The current sweep angle of the full gauge arc in degrees.
public double SweepAngle { get; set; }Can be a numeric value or an expression that evaluates to a numeric value. Expressions are a string that starts with "=".
Gets the collection of RadialGaugeTicks defined for the current Gauge.
[AIAssistantRequired]
[AIAssistantDescription("The tick marks rendered along the gauge's scale. Without them the scale has no visible subdivisions.")]
public RadialGaugeTicksCollection Ticks { get; }Value
object
Gets or sets the current value of the Gauge.
[TypeConverter(typeof(ObjectValueConverter))]
[AIAssistantDescription("The value to be displayed by the Gauge. Can be a numeric value or an expression that evaluates to a numeric value. Expressions are a string that starts with '='. Often, the value is a percentage, showing the progress or part of a whole. For example, if the Gauge is used to show the percentage of sales % of product 'A' achieved, the value might be '= (SUM(If(Fields.Product = \"A\", Fields.Value, 0)) / SUM(Fields.Value)) * 100'.")]
public object Value { get; set; }Can be a numeric value or an expression that evaluates to a numeric value. Expressions are a string that starts with "=". Often, the value is a percentage, showing the progress or part of a whole. For example, if the Gauge is used to show the percentage of sales % of product "A" achieved, the value might be "= (SUM(If(Fields.Product = "A", Fields.Value, 0)) / SUM(Fields.Value)) * 100".