Class
LinearGauge

Internal use only

Definition

Namespace:Telerik.Reporting

Assembly:Telerik.Reporting.dll

Syntax:

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

Inheritance: objectReportObjectReportItemBaseReportItemDataItemLinearGauge

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

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

cs-api-definition
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

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.

Indicator

Gets the LinearGaugeIndicator defined for the current Gauge.

Declaration

cs-api-definition
public LinearGaugeIndicator Indicator { get; }

Property Value

LinearGaugeIndicator

Labels

Gets the collection of LinearGaugeLabels defined for the current Gauge.

Declaration

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

Property Value

LinearGaugeLabelsCollection

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

cs-api-definition
public bool Mirrored { get; set; }

Property Value

bool

bool

Orientation

Gets or sets the orientation of the gauge.

Declaration

cs-api-definition
public GaugeOrientation Orientation { get; set; }

Property Value

GaugeOrientation

Ranges

Gets the collection of LinearGaugeRange defined for the current Gauge.

Declaration

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

Property Value

LinearGaugeRangeCollection

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

cs-api-definition
public bool Reversed { get; set; }

Property Value

bool

bool

Scales

Gets the collection of LinearGaugeScale defined for the current Gauge.

Declaration

cs-api-definition
public LinearGaugeScaleCollection Scales { get; }

Property Value

LinearGaugeScaleCollection

Ticks

Gets the collection of LinearGaugeTicks defined for the current Gauge.

Declaration

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

Property Value

LinearGaugeTicksCollection

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 "=".