Vue CircularGauge - subvalueIndicator
Specifies the appearance options of subvalue indicators.
The CircularGauge widget can display one main value and several subvalues. The gauge's main value and subvalues are indicated by special pointers. You can customize the appearance of these pointers using the valueIndicator and subvalueIndicator configuration objects correspondingly.
The subvalue indicator is a pointer which designates an extra value on a scale. There are several types of subvalue indicators. Set the required one by using the type option, and then specify the options that are specific to this type, if needed. To learn about the options that can be specified for a particular type, refer to one of the following sections.
backgroundColor
Specifies the background color for the indicator of the rangeBar type.
baseValue
Specifies the base value for the indicator of the rangeBar type.
By default, a range bar starts from the beginning of the gauge scale. If you need to draw the range bar starting from a specific scale value, assign the required value to the baseValue option. In this instance, the range bar will display the range from the baseValue to the main gauge value.
beginAdaptingAtRadius
Specifies a radius small enough for the indicator to begin adapting.
When adapting, the indicator adjusts its parts and surroundings proportionally to the changing widget size. The adjustments affect the incidator's indent from the center, the offset from the scale, and the spindle's size and gap.
horizontalOrientation
Specifies the orientation of the rangeBar indicator. Applies only if the geometry.orientation option is "vertical".
This option specifies the orientation of the indicator relative to an invisible scale line.
Use the HorizontalEdge
enum to specify this option when the widget is used as an ASP.NET MVC Control. This enum accepts the following values: Left
and Right
.
indentFromCenter
Specifies the distance between the needle and the center of a gauge for the indicator of a needle-like type.
length
Specifies the indicator length.
palette
Sets the palette to be used to colorize indicators differently.
This option accepts either the name of a predefined palette or an array of colors. The array can include the following colors:
- Hexadecimal colors
- RGB colors
- RGBA colors
- Predefined/cross-browser color names
- Predefined SVG colors
Use the VizPalette
enum to specify this option when the widget is used as an ASP.NET MVC Control. This enum accepts the following values: Default
, SoftPastel
, HarmonyLight
, Pastel
, Bright
, Soft
, Ocean
, Vintage
, Violet
, Carmine
, DarkMoon
, SoftBlue
, DarkViolet
, and GreenMist
.
secondColor
Specifies the second color for the indicator of the twoColorNeedle type.
When you use a twoColorNeedle indicator, define the colors for it using the color and secondColor options. The color option sets the color for the base of the needle. The secondColor option sets the color for the tip of the needle.
In addition, you can specify the ratio between the main and the second color using the secondFraction option.
spindleGapSize
Specifies the inner diameter in pixels, so that the spindle has the shape of a ring.
Set this property to 0 so that the spindle has the shape of a circle.
spindleSize
Specifies the spindle's diameter in pixels for the indicator of a needle-like type.
text
Specifies the appearance of the text displayed in an indicator of the rangeBar type.
Note that the indent option of the text configuration object must not be set to 0 if you need to show the text.
type
Specifies the type of subvalue indicators.
Different options of the subvalueIndicator configuration object can be set for different types of the subvalue indicators. These options are listed within the Indicator Types section.
Use the GaugeIndicatorType
enum to specify this option when the widget is used as an ASP.NET MVC Control. This enum accepts the following values: RectangleNeedle
, TriangleNeedle
, TwoColorNeedle
, RangeBar
, TriangleMarker
, and TextCloud
.
verticalOrientation
Specifies the orientation of the rangeBar indicator. Applies only if the geometry.orientation option is "horizontal".
This option specifies the orientation of an indicator relative to an invisible scale line.
Use the VerticalEdge
enum to specify this option when the widget is used as an ASP.NET MVC Control. This enum accepts the following values: Top
and Bottom
.
width
Specifies the width of an indicator in pixels.
If you have technical questions, please create a support ticket in the DevExpress Support Center.