Gauge Scale Properties
These properties affect gauge scales. A gauge scale fits into one of three categories, based on whether it has ticks, labels, or a track. Each category has its own properties.
For a guide to using gauges, see Designing Gauges.
Gauges and gauge scales can also be affected using Common Properties.
Shared Gauge Scale Properties
These properties affect the shape of any type of gauge scale.
Scale Type
Scale Type
Scale Type
Specifies whether the shape of the scale is defined by a circle or a straight line.
The Scale Type property
Start Angle
Start Angle
Start Angle
Defines the start angle of the circular scale. A value of zero indicates the top of the circle. Valid values are between −180 and 180.
The Start Angle property
End Angle
End Angle
End Angle
Defines the end angle of the circular scale. A value of zero indicates the top of the circle. Valid values are between −180 and 180.
The End Angle property
Radius
Radius
Radius
Defines the radius of the circle that defines the scale, as a percentage of either half the width or half the height of the container, whichever is larger.
The Radius property
Left Padding
Left Padding
Left Padding
Defines the distance between the left side of a linear scale and the container boundary, in pixels. If a border stroke is defined, defines the distance between the scale and the border stroke. See Borders, Padding, and Content Size.
The Left Padding property
Right Padding
Right Padding
Right Padding
Defines the distance between the right side of a linear scale and the container boundary, in pixels. If a border stroke is defined, defines the distance between the scale and the border stroke. See Borders, Padding, and Content Size.
The Right Padding property
Scale Ticks Renderer Properties
These properties affect a scale with ticks.
Ticks Placement
Ticks Placement
Ticks Placement
Specifies whether the ticks are positioned on the inside, outside, or center of the circle or line that defines the scale.
The Ticks Placement property
Major Tick Count
Major Tick Count
Major Tick Count
Defines the total number of major ticks along this scale.
The Major Tick Count property
Major Tick Length
Major Tick Length
Major Ticks Length
Defines the length of each major tick, as a pixel value or a percentage. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of half the container width.
The Major Tick Length property
Major Tick Stroke Color
Major Tick Stroke Color
Defines the stroke color of the major ticks.
The Major Tick Color property
Major Tick Stroke Weight
Major Tick Stroke Weight
Major Tick Stroke Weight
Defines the stroke weight of each major tick.
The Major Tick Weight property
Minor Tick Count
Minor Tick Count
Minor Tick Count
Defines the number of minor ticks between each consecutive pair of major ticks.
The Minor Tick Count property
Minor Tick Length
Minor Tick Length
Minor Tick Length
Defines the length of each minor tick, as a pixel value or a percentage. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of half the container width.
The Minor Tick Length property
Minor Tick Stroke Color
Minor Tick Stroke Color
Minor Tick Stroke Color
Defines the stroke color of the minor ticks.
The Minor Tick Color property
Minor Tick Stroke Weight
Minor Tick Stroke Weight
Minor Tick Stroke Weight
Defines the stroke weight of each minor tick.
The Minor Tick Weight property
Scale Labels Renderer Properties
These properties affect a scale with number labels.
Justify
Justify
Justify
Specifies whether the labels appear on the inside, outside, or center of the circle or line that defines the scale.
The Justify property
Minimum
Minimum
Minimum
Defines the lowest number on the scale.
The Minimum property
Maximum
Maximum
Maximum
Defines the highest number on the scale.
The Maximum property
Labels Count
Labels Count
Labels Count
Defines the total number of labels along this scale. Must be an integer greater than or equal to 2. The Only Min/Max Labels property overrides this property.
The Labels Count property
Only Min/Max Labels
Only Min/Max Labels
Only Min/Max Labels
Specifies whether the labels for the minimum and maximum of the scale are the only two labels that appear. This property overrides the Labels Count property.
The Only Min/Max Labels property
Format
Format
Format
Defines the number format for scale labels, as a format string.
For example:
- ,##0.00: Labels have a thousands separator and two decimal digits.
- 000.00: Labels have three mandatory digits before the decimal, and two mandatory digits after the decimal.
For more information about supported formatting options, see Scripting and Syntax.
The Format property
Labels Font
Labels Font
Labels Font
Defines the font used for the labels along this scale. To add a font to this project and use it for this property, see Text Component Properties.
The Font property
Labels Size
Labels Size
Labels Size
Defines the height of the scale numbers, as a pixel value or percentage. For circular scales, a percentage is a portion of the circle's radius. For linear scales, a percentage is a portion of half the container width.
The Labels Size property
Italic
Italic
Italic
Defines whether the labels along this scale are italic.
The Italic property
Bold
Bold
Bold
Defines whether the labels along this scale are bold.
The Bold property
Underline
Underline
Underline
Defines whether the labels along this scale are underlined.
The Underline property
Character Spacing
Character Spacing
Character Spacing
Specifies the horizontal spacing between characters in the scale labels, as a pixel value. A null value means the font's default spacing is used.
The Character Spacing property
Scale Track Renderer Properties
These properties affect a scale with a track.
Start Thickness
Start Thickness
Start Thickness
Defines the thickness of the scale track at its start, as a pixel or percentage value. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of the entire container width.
The Start Thickness property
End Thickness
End Thickness
End Thickness
Defines the thickness of the scale track at its end, as a pixel or percentage value. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of the entire container width.
The End Thickness property
Track Fill
Track Fill
Track Fill
Defines the colors for the gradient fill for the scale track. To add colors, click below the track in the dialog. To delete colors, right-click on them in the dialog.
The Track Fill property
Track Placement
Track Placement
Track Placement
Specifies whether the track is positioned on the inside, outside, or center of the circle or line that defines the scale.
The Track Placement property