commonNeedleSettings

An object that defines the configuration options that are common for all gauge needles.

Type: Object

Use this object's properties to set options for all gauge needles at once. If you need to set an individual value for a common option, use the corresponding needle object within the needles array. The values that are set individually override the corresponding common values.

color

Specifies the color of a needle.

Type: String
Default Value: '#C2C2C2'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/Cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)

indentFromCenter

Specifies, in pixels, the indent from the needle's base to the center of the dxCircularGauge widget.

Type: Number
Default Value: 0

offset

Specifies the offset of a needle from an invisible scale line in pixels.

Type: Number
Default Value: 20

The offset property specifies the indent of the needle's tip from the invisible scale line.

secondColor

Specifies the second color of a 'twoColorRectangle' needle (see type).

Type: String
Default Value: '#E18E92'

The following colors are used to set a 'twoColorRectangle' needle:

  • color - the color of the needle's base fraction;
  • secondColor - the color of the needle's tip fraction;

secondFraction

Specifies the length, in percentage, of the tip in the 'twoColorRectangle' needle (see type).

Type: Number
Default Value: 0.4

type

Specifies the needle type.

Type: String
Default Value: 'rectangle'
Accepted Values: 'rectangle' | 'triangle' | 'twoColorRectangle'

Needle types for the dxCircularGauge widget:

Needle Type Properties
'rectangle' offset, indentFromCenter, width, color
'triangle' offset, indentFromCenter, width, color
'twoColorRectangle' offset, indentFromCenter, width, secondFraction, color, secondColor

width

Specifies, the width of a needle in pixels.

Type: Number
Default Value: 2