ClassLinearGauge
Internal use only
Definition
Namespace:Telerik.Reporting
Assembly:Telerik.Reporting.dll
Syntax:
[ToolboxBitmap(typeof(LinearGauge), "Resources.GaugeLinear.png")]
public class LinearGauge : DataItem, IToggleVisibilityTarget, IActionTarget, IDataItem, IDataFlow, IDataSourceContainer
Inheritance: objectReportObjectReportItemBaseReportItemDataItemLinearGauge
Implements:
Inherited Members
Constructors
LinearGauge()
The linear gauge report item used to visualize key performance indicators (KPIs) along a horizontal or vertical scale. It displays values using pointers, ranges, labels, and ticks to show progress relative to defined minimum and maximum values. Commonly used in reports and dashboards to present metrics such as percentages, capacity usage, or progress toward a goal.
Declaration
public LinearGauge()
Properties
DataSource
Gets or sets the data source that the LinearGauge is displaying data for. If not set, the Gauge will use the parent item's data scope.
Declaration
[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
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.
Indicator
Gets the LinearGaugeIndicator defined for the current Gauge.
Declaration
public LinearGaugeIndicator Indicator { get; }
Property Value
Labels
Gets the collection of LinearGaugeLabels defined for the current Gauge.
Declaration
public LinearGaugeLabelsCollection Labels { get; }
Property Value
Mirrored
Gets or sets the Mirrored property of the gauge which generates a mirrored projection of its contents. The default layout is scales-below-the-ranges for horizontal and scales-on-the-left-of-the-ranges for vertical gauge.
Declaration
public bool Mirrored { get; set; }
Property Value
bool
boolOrientation
Gets or sets the orientation of the gauge.
Declaration
public GaugeOrientation Orientation { get; set; }
Property Value
Ranges
Gets the collection of LinearGaugeRange defined for the current Gauge.
Declaration
public LinearGaugeRangeCollection Ranges { get; }
Property Value
Reversed
Gets or sets the Reversed property of the gauge which determines the drawing direction for its ranges. The default direction is left-to-right for horizontal and bottom-to-top for vertical gauge.
Declaration
public bool Reversed { get; set; }
Property Value
bool
boolScales
Gets the collection of LinearGaugeScale defined for the current Gauge.
Declaration
public LinearGaugeScaleCollection Scales { get; }
Property Value
Ticks
Gets the collection of LinearGaugeTicks defined for the current Gauge.
Declaration
public LinearGaugeTicksCollection Ticks { get; }
Property Value
Value
Gets or sets the current value of the Gauge.
Declaration
[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 "=".