|
| 1 | +--- |
| 2 | +title: Linear Gauge |
| 3 | +page_title: Linear Gauge Configuration and Usage |
| 4 | +description: "Learn how to insert and configure the Telerik Reporting Linear Gaugein order to display linear scales such as thermometers, tanks, color indicators (LED)." |
| 5 | +slug: telerikreporting/designing-reports/report-structure/gauge/linear-gauge |
| 6 | +tags: telerik, reporting, report, items, Linear, gauge, properties |
| 7 | +published: True |
| 8 | +position: 2 |
| 9 | +--- |
| 10 | + |
| 11 | +# Using the Linear Gauge Report Item |
| 12 | + |
| 13 | +The steps below will demonstrate how to add the Telerik Reporting Linear Gauge report item to reports. |
| 14 | + |
| 15 | +## Adding a Linear Gauge to the Report |
| 16 | + |
| 17 | +* [Standalone Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%}) - The Gauge item can be inserted from the `Insert Ribbon`: |
| 18 | + |
| 19 | +  |
| 20 | + |
| 21 | +* [Web Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/overview%}) - The Gauge item can be inserted using the `Components Tab`: |
| 22 | + |
| 23 | +  |
| 24 | + |
| 25 | +* [Visual Studio Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/overview%}) - The Gauge item can be inserted from the [Visual Studio Toolbox](https://learn.microsoft.com/en-us/visualstudio/ide/reference/toolbox) |
| 26 | + |
| 27 | +## Properties of the Gauge Report Item |
| 28 | + |
| 29 | +The Gauge Report Item is a [data item]({%slug telerikreporting/designing-reports/connecting-to-data/data-items/overview%}) and as such inherits the properties of the [Telerik.Reporting.DataItem](/api/telerik.reporting.dataitem) class. |
| 30 | + |
| 31 | +### Properties specific to the Appearance |
| 32 | + |
| 33 | +* [`Mirrored`](/api/telerik.reporting.lineargauge#Telerik_Reporting_LinearGauge_Mirrored) - The Linear Gauge item generates a mirrored projection of its contents. The default layout for `Horizontal` is to display it below the ranges while for `Vertical`, it is rendered left of the gauge. |
| 34 | +* [`Orientation`](/api/telerik.reporting.lineargauge#Telerik_Reporting_LinearGauge_Orientation) - Determines whether the gauge will be rendered using a horizontal or vertical scale. |
| 35 | +* [`Reversed`](/api/telerik.reporting.lineargauge#Telerik_Reporting_LinearGauge_Reversed) - Determines the direction of the ranges and scale of the gauge. For `Horizontal` orientation, the default direction is left-to-right while for `Vertical` gauge, it is bottom-to-top. |
| 36 | +* [`Value`](/api/telerik.reporting.lineargauge#Telerik_Reporting_LinearGauge_Value) - Represents the value of the gauge for the current instance. |
| 37 | + |
| 38 | + |
| 39 | + |
| 40 | +### Properties specific to the Presentation |
| 41 | + |
| 42 | +* [`Indicator`](/api/telerik.reporting.lineargauge#Telerik_Reporting_LinearGauge_Indicator) - Represents a [LinearGaugeIndicator](/api/telerik.reporting.lineargaugeindicator) instance defining the visual type of the indicator. |
| 43 | + - [`Length`](/api/telerik.reporting.lineargaugeindicator#collapsible-Telerik_Reporting_LinearGaugeIndicator_Length) - Represents the length of the length of the indicator used to display the current value. The value is used as percentage ratio to the total gauge `Width`. |
| 44 | + - [`Offset`](/api/telerik.reporting.lineargaugeindicator#Telerik_Reporting_LinearGaugeIndicator_Offset) - Represents the length of the offset of the indicator used to display the current value relative to the gauge range. The value is used as percentage ratio to the total gauge `Width`. For example, if the value is 0, the indicator would start at the left border of the item and vice versa. |
| 45 | + - [`Style`](/api/telerik.reporting.lineargaugeindicator#Telerik_Reporting_LinearGaugeIndicator_Style) - Represents a [Style](/api/telerik.reporting.drawing.style) instance, used to style indicator elemen |
| 46 | + - [`Thickness`](/api/telerik.reporting.lineargaugeindicator#Telerik_Reporting_LinearGaugeIndicator_Thickness) - Represents a ratio of the value of the [Style.LineWidth](/api/telerik.reporting.drawing.style#Telerik_Reporting_Drawing_Style_LineWidth) of the indicator. |
| 47 | + - [`Type`](/api/telerik.reporting.lineargaugeindicator#Telerik_Reporting_LinearGaugeIndicator_Type) - Represents the type of indicator to be displayed next to the linear guage. The available options are listen in the [IndicatorType](/api/telerik.reporting.indicatortype) enum. |
| 48 | +* [`Labels`](/api/telerik.reporting.lineargauge#collapsible-Telerik_Reporting_LinearGauge_Labels) - The [LinearGaugeLabels](/api/telerik.reporting.lineargaugelabels) collection associated with this gauge item. |
| 49 | + - [`FirstVisibleValue`](/api/telerik.reporting.gaugelabelsbase#Telerik_Reporting_GaugeLabelsBase_FirstVisibleValue) - Represents the value of the minimum value for which a label will be rendered. Can be used to restraint the label set. If left empty, all labels will be visible. |
| 50 | + - [`Format`](/api/telerik.reporting.gaugelabelsbase#Telerik_Reporting_GaugeLabelsBase_Format) - Represents the format that will be applied on the labels of the linear gauge. |
| 51 | + - [`Offset`](/api/telerik.reporting.lineargaugelabels#Telerik_Reporting_LinearGaugeLabels_Offset) - Represents the offset of the label strings from the gauge range. The value is used as percentage ratio to the total gauge `Width`. |
| 52 | + - [`RenderingType`](/api/telerik.reporting.lineargaugelabels#Telerik_Reporting_LinearGaugeLabels_RenderingType) - Represents the selected `RenderingType` options for the given label. |
| 53 | + - [`LastVisibleValue`](/api/telerik.reporting.gaugelabelsbase#Telerik_Reporting_GaugeLabelsBase_LastVisibleValue) - Represents the value of the maximum value for which a label will be rendered. Can be used to restraint the label set. If left empty, all labels will be visible. |
| 54 | + - [`SegmentCount`](/api/telerik.reporting.gaugelabelsbase#Telerik_Reporting_GaugeLabelsBase_SegmentCount) - Represents the total count of labels that will be generated. It is recommended to be equal to the count of the `Ticks`. |
| 55 | + - [`Style`](/api/telerik.reporting.gaugelabelsbase#Telerik_Reporting_GaugeLabelsBase_Style) - Represents a [Style](/api/telerik.reporting.drawing.style) instance, used to style the labels. |
| 56 | +* [`Ranges`](/api/telerik.reporting.lineargauge#Telerik_Reporting_LinearGauge_Ranges) - The [LinearGaugeRanges](/api/telerik.reporting.lineargaugerange) collection associated with this gauge item. A gauge can have multiple ranges. |
| 57 | + |
| 58 | + - [`End`](/api/telerik.reporting.lineargaugerange#Telerik_Reporting_LinearGaugeRange_End) - Represents the top value of the linear gauge's range. |
| 59 | + - [`EndWidth`](/api/telerik.reporting.lineargaugerange#Telerik_Reporting_LinearGaugeRange_EndWidth) - Represents the end width of the linear gauge item in a percentage of the total item `Width`. A value of 50 would mean that the last point of the gauge range area will be half the whole item's width. |
| 60 | + - [`Offset`](/api/telerik.reporting.lineargaugerange#Telerik_Reporting_LinearGaugeRange_Offset) - Represents the offset of the range area from the left/top border of the itme. The value is used as percentage ratio to the total gauge `Width`. |
| 61 | + - [`Start`](/api/telerik.reporting.lineargaugerange#Telerik_Reporting_LinearGaugeRange_Start) - Represents the bottom value of the linear gauge's range. |
| 62 | + - [`StartWidth`](/api/telerik.reporting.lineargaugerange#Telerik_Reporting_LinearGaugeRange_StartWidth) - Represents the start width of the linear gauge item in a percentage of the total item `Width`. A value of 50 would mean that the first point of the gauge range area will be half the whole item's width. |
| 63 | + - [`Style`](/api/telerik.reporting.lineargaugerange#Telerik_Reporting_LinearGaugeRange_Style) - Represents a [Style](/api/telerik.reporting.drawing.style) instance, used to style the range area. |
| 64 | +* [`Scales`](/api/telerik.reporting.lineargauge#collapsible-Telerik_Reporting_LinearGauge_Scales) - The [LinearGaugeScales](/api/telerik.reporting.lineargaugescalecollection) collection associated with this gauge item. A gauge can have multiple ranges. This is how the `Three-range` gauge is implemented. |
| 65 | + |
| 66 | + - [`End`](/api/telerik.reporting.lineargaugescale#Telerik_Reporting_LinearGaugeScale_End) - Represents the top value of the linear gauge's scale line. |
| 67 | + - [`Offset`](/api/telerik.reporting.lineargaugescale#Telerik_Reporting_LinearGaugeScale_Offset) - Represents the offset of the scale line from the left/top border of the item. The value is used as percentage ratio to the total gauge `Width`. |
| 68 | + - [`Start`](/api/telerik.reporting.lineargaugescale#Telerik_Reporting_LinearGaugeScale_Start) - Represents the bottom value of the linear gauge's scale line. |
| 69 | + - [`Style`](/api/telerik.reporting.lineargaugescale#Telerik_Reporting_LinearGaugeScale_Style) instance, used to style the scale line |
| 70 | +* [`Ticks`](/api/telerik.reporting.lineargauge#collapsible-Telerik_Reporting_LinearGauge_Ticks) - The [LinearGaugeTicks](/api/telerik.reporting.lineargaugetickscollection) collection associated with this gauge item. |
| 71 | + - [`FirstVisibleIndex`](/api/telerik.reporting.gaugeticksbase#Telerik_Reporting_GaugeTicksBase_FirstVisibleIndex) - Represents the starting tick index from which ticks will be rendered. Can be used to constraint the tick set in a smaller range than the full scale. Ticks indexing starts at `0`. |
| 72 | + - [`LastVisibleIndex`](/api/telerik.reporting.gaugeticksbase#Telerik_Reporting_GaugeTicksBase_LastVisibleIndex) - Represents the last tick index until which ticks will be rendered. Can be used to constraint the tick set in a smaller range than the full scale. Ticks indexing starts at `0`. |
| 73 | + - [`Length`](/api/telerik.reporting.gaugeticksbase#Telerik_Reporting_GaugeTicksBase_Length) - Represents the size of the tick's visual element in percentage ratio to the gauge radius. |
| 74 | + - [`Offset`](/api/telerik.reporting.lineargaugeticks#Telerik_Reporting_LinearGaugeTicks_Offset) - Represents the offset of the range area from the left/top border of the itme. The value is used as percentage ratio to the total gauge `Width`. |
| 75 | + - [`SegmentCount`](/api/telerik.reporting.gaugeticksbase#Telerik_Reporting_GaugeTicksBase_SegmentCount) - Represents the total count of ticks that will be generated for the given gauge range. |
| 76 | + - [`Type`](/api/telerik.reporting.gaugeticksbase#Telerik_Reporting_GaugeTicksBase_TickType) - Represents the type of the shape that will be used for rendering the ticks. |
| 77 | + - [`Style`](/api/telerik.reporting.gaugeticksbase#Telerik_Reporting_GaugeTicksBase_Style) - Represents a [Style](/api/telerik.reporting.drawing.style) instance, used to style range sectors. |
| 78 | + |
| 79 | +## See Also |
| 80 | + |
| 81 | +* [Gauge Report Item Overview]({%slug telerikreporting/designing-reports/report-structure/gauge/overview%}) |
| 82 | +* [Radial Gauge Configuration and Usage]({%slug telerikreporting/designing-reports/report-structure/gauge/radial-gauge%}) |
| 83 | +* [Data Items]({%slug telerikreporting/designing-reports/connecting-to-data/data-items/overview%}) |
0 commit comments