Class
RadialGauge

TODO: Add documentation.

Definition

Namespace:Telerik.Reporting

Assembly:Telerik.Reporting.dll

Syntax:

cs-api-definition
[ToolboxBitmap(typeof(RadialGauge), "Resources.GaugeRadial.png")]
public class RadialGauge : DataItem, IToggleVisibilityTarget, IActionTarget, IDataItem, IDataFlow, IDataSourceContainer

Inheritance: objectReportObjectReportItemBaseReportItemDataItemRadialGauge

Implements: IActionTargetIDataFlowIDataItemIDataSourceContainerIToggleVisibilityTarget

Inherited Members DataItem.OnNeedDataSource(object, EventArgs)DataItem.NeedDataSourceMethodNameDataItem.FiltersDataItem.NoDataMessageDataItem.NoDataStyleDataItem.SortingsDataItem.SortingDataItem.NeedDataSourceReportItem.SizeReportItem.LocationReportItem.AnchoringReportItem.DockingReportItem.BoundsReportItem.LeftReportItem.RightReportItem.TopReportItem.BottomReportItem.WidthReportItem.HeightReportItem.DefaultSizeReportItemBase.Dispose()ReportItemBase.Dispose(bool)ReportItemBase.ToString()ReportItemBase.Contains(ReportItemBase)ReportItemBase.GetEventHandlers(EventHandler)ReportItemBase.OnItemValidate(ReportItemBase)ReportItemBase.ClearGlobalDependencies()ReportItemBase.ContainerReportItemBase.DesignModeReportItemBase.SiteReportItemBase.NameReportItemBase.ItemDataBindingMethodNameReportItemBase.ItemDataBoundMethodNameReportItemBase.VisibleReportItemBase.StyleNameReportItemBase.StyleReportItemBase.ItemsReportItemBase.ParentReportItemBase.ReportReportItemBase.ConditionalFormattingReportItemBase.BookmarkReportItemBase.BookmarkIdReportItemBase.DocumentMapTextReportItemBase.TocTextReportItemBase.TocLevelReportItemBase.ActionReportItemBase.BindingsReportItemBase.ToolTipReportItemBase.AccessibleDescriptionReportItemBase.AccessibleRoleReportItemBase.AIDescriptionReportItemBase.ItemDataBindingReportItemBase.ItemDataBoundReportItemBase.DisposedReportObject.ToString(string[])

Constructors

RadialGauge()

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.

Declaration

cs-api-definition
public RadialGauge()

Properties

DataSource

Gets or sets the data source that the RadialGauge is displaying data for. If not set, the Gauge will use the parent item's data scope.

Declaration

cs-api-definition
[TypeConverter(typeof(DataSourceConverter))]
[AIAssistantRename("DataSourceName")]
[AIAssistantByRef("/DataSources")]
[AIAssistantRequired(false)]
public override object DataSource { get; set; }

Property Value

object

An object that functions as a data source.

Overrides DataItem.DataSource

Remarks

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.

Labels

Gets the collection of RadialGaugeLabels defined for the current Gauge.

Declaration

cs-api-definition
public RadialGaugeLabelsCollection Labels { get; }

Property Value

RadialGaugeLabelsCollection

Needle

Gets the needle defined for the current Gauge.

Declaration

cs-api-definition
public RadialGaugeNeedle Needle { get; }

Property Value

RadialGaugeNeedle

Ranges

Gets the collection of RadialGaugeRange defined for the current Gauge.

Declaration

cs-api-definition
public RadialGaugeRangeCollection Ranges { get; }

Property Value

RadialGaugeRangeCollection

StartAngle

Gets or sets the current start angle of the full gauge arc in degrees.

Declaration

cs-api-definition
public double StartAngle { get; set; }

Property Value

double

Can be a numeric value.

SweepAngle

Gets or sets the current sweep angle of the full gauge arc in degrees.

Declaration

cs-api-definition
public double SweepAngle { get; set; }

Property Value

double

Can be a numeric value or an expression that evaluates to a numeric value. Expressions are a string that starts with "=".

Ticks

Gets the collection of RadialGaugeTicks defined for the current Gauge.

Declaration

cs-api-definition
public RadialGaugeTicksCollection Ticks { get; }

Property Value

RadialGaugeTicksCollection

Value

Gets or sets the current value of the Gauge.

Declaration

cs-api-definition
[TypeConverter(typeof(ObjectValueConverter))]
public object Value { get; set; }

Property Value

object

Can be a numeric value or an expression that evaluates to a numeric value. Expressions are a string that starts with "=".