Gauge Components
Available gauges include the C1RadialGauge and C1LinearGauge components (both are derived from the C1GaugeBase class). Gauges aren't Controls; they are simple Components that can be added to the C1Gauge.Gauges collection.
You can select gauges on the designer surface and edit their properties/events in the standard property grid, in the special Item Editor, or in the collection editor for the C1Gauge.Gauges collection property. Gauge's designer supports the standard operations, such as Cut, Copy, Paste, Delete, "Bring to Front", "Send to Back". Also, you can right-click individual gauges to display their context menu. This allows quick editing of the C1GaugeBase.FaceShapes/C1GaugeBase.CoverShapes, and C1GaugeBase.Decorators collections.
Gauges can be saved as XML templates, and then loaded from XML files. You can also save/load the layout and appearance settings for individual gauges.
You can bind gauge to a data source using the standard .NET data-binding technique. If there are several pointers in the gauge you can bind these pointers to different data sources (up to 5 pointers for a gauge).
The main properties of the base C1GaugeBase class include:
- C1GaugeBase.Decorators – the collection of various decorators, such as labels and tick marks.
- C1GaugeBase.FaceShapes and C1GaugeBase.CoverShapes – two collections of shapes that appear behind everything (FaceShapes) and above everything (CoverShapes) in the gauge.
- C1GaugeBase.Pointer – this is the main pointer of the gauge. You can hide the main pointer but can't delete it.
- C1GaugeBase.MorePointers – the collection of other pointers.
- C1GaugeBase.Value – the current value of the main pointer.
- C1GaugeBase.Minimum and C1GaugeBase.Maximum – specify the lower and upper bounds for all pointer values, for example scaled values.
- C1GaugeBase.Viewport – specifies the bounds of the gauge working area.
In the following topics, you'll see the specific properties of radial and linear gauges.