RadialGauge
TODO: Add documentation.
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))]
[AIAssistantRename("DataSourceName")]
[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.
public RadialGaugeLabelsCollection Labels { get; }The needle defined for the current Gauge.
public RadialGaugeNeedle Needle { get; }The collection of RadialGaugeRange defined for the current Gauge.
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.
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".