(Flex Data Visualization components only)
Packagemx.charts
Classpublic class ChartItem
InheritanceChartItem Inheritance EventDispatcher Inheritance Object
Subclasses AreaSeriesItem, BarSeriesItem, BubbleSeriesItem, ColumnSeriesItem, HLOCSeriesItem, LineSeriesItem, PieSeriesItem, PlotSeriesItem

A ChartItem represents a single item in a ChartSeries. In most standard series, there is one ChartItem created for each item in the series' dataProvider collection. ChartItems are passed to the instances of a series' itemRenderer for rendering. Most Series types extend ChartItem to contain additional information specific to the chart type.

See also

Skinning ChartItem objects
Selecting chart items

Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  currentState : String
Defines the appearance of the ChartItem.
ChartItem
  element : IChartElement
The series or element that owns the ChartItem.
ChartItem
  index : int
The index of the data from the series' data provider that the ChartItem represents.
ChartItem
  item : Object
The item from the series' data provider that the ChartItem represents.
ChartItem
  itemRenderer : IFlexDisplayObject
The instance of the chart's itemRenderer that represents this ChartItem.
ChartItem
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined By
  
ChartItem(element:IChartElement = null, item:Object = null, index:uint = 0)
Constructor.
ChartItem
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
  
clone():ChartItem
Returns a copy of this ChartItem.
ChartItem
 Inherited
dispatchEvent(event:Event):Boolean
Dispatches an event into the event flow.
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
toLocaleString():String
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
toString():String
Returns the string representation of the specified object.
Object
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
 Inherited
willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Events
 Event Summary Defined By
 Inherited
activate
[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.EventDispatcher
 Inherited
deactivate
[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.EventDispatcher
Public Constants
 ConstantDefined By
  DISABLED : String = "disabled"
[static] Value that indicates the ChartItem appears disabled and cannot be selected.
ChartItem
  FOCUSED : String = "focused"
[static] Value that indicates the ChartItem has focus but does not appear to be selected.
ChartItem
  FOCUSEDSELECTED : String = "focusedSelected"
[static] Value that indicates the ChartItem appears to have focus and appears to be selected.
ChartItem
  NONE : String = "none"
[static] Value that indicates the ChartItem does not appear to be selected, does not have focus, and is not being rolled over.
ChartItem
  ROLLOVER : String = "rollOver"
[static] Value that indicates the ChartItem appears as if the mouse was over it.
ChartItem
  SELECTED : String = "selected"
[static] Value that indicates the ChartItem appears selected but does not have focus.
ChartItem
Property Detail
currentStateproperty
currentState:String

Defines the appearance of the ChartItem. The currentState property can be set to none, rollOver, selected, disabled, focusSelected, and focused.



Implementation
    public function get currentState():String
    public function set currentState(value:String):void
elementproperty 
public var element:IChartElement

The series or element that owns the ChartItem.

indexproperty 
public var index:int

The index of the data from the series' data provider that the ChartItem represents.

itemproperty 
public var item:Object

The item from the series' data provider that the ChartItem represents.

itemRendererproperty 
public var itemRenderer:IFlexDisplayObject

The instance of the chart's itemRenderer that represents this ChartItem.

Constructor Detail
ChartItem()Constructor
public function ChartItem(element:IChartElement = null, item:Object = null, index:uint = 0)

Constructor.

Parameters
element:IChartElement (default = null) — The series or element to which the ChartItem belongs.
 
item:Object (default = null) — The item from the series' data provider that the ChartItem represents.
 
index:uint (default = 0) — The index of the data from the series' data provider that the ChartItem represents.
Method Detail
clone()method
public function clone():ChartItem

Returns a copy of this ChartItem.

Returns
ChartItem — A copy of this ChartItem.
Constant Detail
DISABLEDConstant
public static const DISABLED:String = "disabled"

Value that indicates the ChartItem appears disabled and cannot be selected.

FOCUSEDConstant 
public static const FOCUSED:String = "focused"

Value that indicates the ChartItem has focus but does not appear to be selected.

FOCUSEDSELECTEDConstant 
public static const FOCUSEDSELECTED:String = "focusedSelected"

Value that indicates the ChartItem appears to have focus and appears to be selected.

NONEConstant 
public static const NONE:String = "none"

Value that indicates the ChartItem does not appear to be selected, does not have focus, and is not being rolled over.

ROLLOVERConstant 
public static const ROLLOVER:String = "rollOver"

Value that indicates the ChartItem appears as if the mouse was over it.

SELECTEDConstant 
public static const SELECTED:String = "selected"

Value that indicates the ChartItem appears selected but does not have focus.




© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Aug 13 2009, 03:11 AM -07:00