Gauges may have one or several pointers. Pointer appears as a figure whole position depends on the current value. Each gauge object has the main pointer (C1GaugeBase.Pointer) and the collection of other pointers (C1GaugeBase.MorePointers).
Each pointer has the Value property. The lower and upper bounds for the pointer value is specified by the Minimum and Maximum property of the owner gauge. If it doesn't belong to the given interval you may use the ValueOffset and ValueFactor properties to coerce the source value, for example, change the unit of measure.
When the Value property changes the pointer redraws at the new location immediately, by default. The SweepTime property allows smooth moving the pointer. It sets the amount of time that is taken to move the pointer from Minimum to Maximum.
There are a few properties that affect pointer's appearance. You can choose among the predefined pointer shapes, create a custom shape, or display a custom image for the pointer. The Offset, Length, and Width properties specify the offset, length, and width of the pointer in logical coordinates at the scale's minimum position. It is possible that the offset and/or length of the pointer will be changed linearly from minimum to maximum values. So there are also the Offset2 and Length2 properties that specify the offset and length at the scale's maximum value.
Pointer values can be bound to a data source. The DataSource and DataMember properties of C1GaugeBase allow easy binding to the main pointer. There is also the special BoundValue property. This is the same as Value (i.e., the value of the main pointer) but it is of type Object and returns DBNull.Value instead of Double.NaN if the pointer is "switched off". The next properties: MorePointersValue_0, MorePointersValue_1, MorePointersValue_2, MorePointersValue_3 allow binding to the first four elements of the MorePointers collection.
|
