Packageardisia.components.gauges
Classpublic class RadialGauge
InheritanceRadialGauge Inheritance GaugeBase Inheritance spark.components.supportClasses.SliderBase

Radial gauge that supports labels, tick marks, and start and end angles.

View the technical documentation on the Ardisia Labs website for more information.



Public Properties
 PropertyDefined By
  angleEnd : Number
The angle at which to end the drawing of the gauge arc in degrees.
RadialGauge
  angleStart : Number
The angle at which to begin drawing the gauge arc in degrees.
RadialGauge
 Inheritededitable : Boolean
Whether the value can be changed via user interaction.
GaugeBase
 InheritedlabelDefaultPrecision : Number
Default precision for the number formatter if a labelsFormatFunction is not provided.
GaugeBase
 InheritedlabelsFormatFunction : Function
The callback function used to format the labels.
GaugeBase
 InheritedmajorTickCount : int
The number of major ticks to display.
GaugeBase
 InheritedminorTickCount : int
The number of minor ticks to display between major ticks.
GaugeBase
 InheritedshowTickLabels : Boolean
True to display labels along with the major ticks.
GaugeBase
 InheritedshowTicks : Boolean
True to display ticks.
GaugeBase
Protected Properties
 PropertyDefined By
  radius : Number
Radius of the arc swept out by the gauge.
RadialGauge
Public Methods
 MethodDefined By
 Inherited
dispose():void
Remove the component from the display list and prepare the component for garbage collection.
GaugeBase
Protected Methods
 MethodDefined By
  
checkAngle(value:Number):Number
Checks that the passed angle is between 0 and 360 and if not, returns the normalized value
RadialGauge
 Inherited
formatLabelText(value:Number):Object
Format the value to a human readable String.
GaugeBase
 Inherited
Update the tick labels skin parts.
GaugeBase
Styles
 Style Description Defined By
  
inset
Type: Number CSS Inheritance: no
The number of pixels by which to inset the gauge within the track. Must be at least 1 pixel. The default value is 15.
RadialGauge
 InheritedType: Number CSS Inheritance: no
The number of pixels to offset the labels from the tick marks.
GaugeBase
 InheritedType: uint Format: Color CSS Inheritance: no
The color of the major ticks.
GaugeBase
 InheritedType: String CSS Inheritance: no
The shape of the major tick mark: line or circle.
GaugeBase
 InheritedType: Number CSS Inheritance: no
The length of the major tick.
GaugeBase
 InheritedType: Number CSS Inheritance: no
The thickness of major tick strokes or the radius of the circle.
GaugeBase
 InheritedType: uint Format: Color CSS Inheritance: no
The color of the minor ticks.
GaugeBase
 InheritedType: String CSS Inheritance: no
The shape of the minor tick mark: line or circle.
GaugeBase
 InheritedType: Number CSS Inheritance: no
The length of the minor tick.
GaugeBase
 InheritedType: Number CSS Inheritance: no
The thickness of minor tick strokes or the radius of the circle.
GaugeBase
  
thumbInset
Type: Number CSS Inheritance: no
The number of pixels by which to inset the tip of the thumb (needle) from the radius of the gauge's arc. The default value is 10.
RadialGauge
 InheritedType: Number CSS Inheritance: no
The number of pixels to offset the tick marks from the track.
GaugeBase
Skin Parts

This component uses skins made up of skin parts. Do not set the skin parts directly. The component's skin sets the skin parts.


 Skin Part Description Defined By
 Inherited
labelsFactoryPart:mx.core.IFactory
Required: false Part Type: Dynamic
Factory that creates the labels that are displayed along with the major ticks. Used by both the linear and radial gauges.

The IFactory must return an object of type Label
GaugeBase
Skin States

To skin the component, implement a skin that defines the following states. Although you must implement all skin states, a skin state can be empty. An empty skin state specifies no changes to the default skin state.


 Skin State Description Defined By
 Inherited State used when the control is disabled, but the component should not be displayed as disabled. Useful to statically present information via a slider. For example: a thermometer to show fundraising totals. GaugeBase
Property Detail
angleEndproperty
angleEnd:Number

The angle at which to end the drawing of the gauge arc in degrees.

The default value is 360.


Implementation
    public function get angleEnd():Number
    public function set angleEnd(value:Number):void
angleStartproperty 
angleStart:Number

The angle at which to begin drawing the gauge arc in degrees.

The default value is 180.


Implementation
    public function get angleStart():Number
    public function set angleStart(value:Number):void
radiusproperty 
protected var radius:Number

Radius of the arc swept out by the gauge.

Method Detail
checkAngle()method
protected function checkAngle(value:Number):Number

Checks that the passed angle is between 0 and 360 and if not, returns the normalized value

Parameters

value:Number — the Number to check

Returns
Number — normalized value