Packagemx.charts
Classpublic class HitData
InheritanceHitData Inheritance Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The HitData class represents information about the data item at a specific location on the screen. Flex returns the HitData structure for mouse events on chart data points. It describes what data points are under the current mouse position.

You can also get a HitData structure describing the data point at a specific location in the chart using the chart control's findDataPoints() method.

See also

mx.charts.ChartItem


Public Properties
 PropertyDefined By
  chartItem : ChartItem
The chart item described by the hit data.
HitData
  contextColor : uint = 0
An RGB value that can be used to associate an on-screen representation of the associated chartItem.
HitData
  dataTipFunction : Function
A function provided by the HitData creator to generate a user-suitable String for display on screen that describes the referenced item.
HitData
  displayText : String
[read-only] A description of the associated item for display on screen.
HitData
  distance : Number
Specifies the distance between the data item on the screen and the location of the mouse pointer, in pixels.
HitData
  element : IChartElement
[read-only] Specifies the chart element rendering this data item that generated the HitData structure.
HitData
  id : Number
Specifies a unique identifier representing the data point.
HitData
  item : Object
Specifies the data item that the HitData structure describes.
HitData
  x : Number
Specifies the X coordinate of the data item on the screen.
HitData
  y : Number
Specifies the Y coordinate of the data item on the screen.
HitData
Public Methods
 MethodDefined By
  
HitData(id:Number, distance:Number, x:Number, y:Number, chartItem:ChartItem)
Constructor.
HitData
Property Detail
chartItemproperty
public var chartItem:ChartItem

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The chart item described by the hit data. A chart item represents the data a series uses to describe an individual item from its dataProvider.

contextColorproperty 
public var contextColor:uint = 0

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

An RGB value that can be used to associate an on-screen representation of the associated chartItem. DataTips use this field to help render their data.

dataTipFunctionproperty 
public var dataTipFunction:Function

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

A function provided by the HitData creator to generate a user-suitable String for display on screen that describes the referenced item.

displayTextproperty 
displayText:String  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

A description of the associated item for display on screen.


Implementation
    public function get displayText():String
distanceproperty 
public var distance:Number

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies the distance between the data item on the screen and the location of the mouse pointer, in pixels.

elementproperty 
element:IChartElement  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies the chart element rendering this data item that generated the HitData structure.


Implementation
    public function get element():IChartElement
idproperty 
public var id:Number

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies a unique identifier representing the data point. You can use this identifier to test for equality between two HitData objects. If two different chart elements represent the same dataProvider entry, they will have two different identifiers.

itemproperty 
public var item:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies the data item that the HitData structure describes.

xproperty 
public var x:Number

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies the X coordinate of the data item on the screen.

yproperty 
public var y:Number

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Specifies the Y coordinate of the data item on the screen.

Constructor Detail
HitData()Constructor
public function HitData(id:Number, distance:Number, x:Number, y:Number, chartItem:ChartItem)

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Constructor.

Parameters
id:Number — Specifies a unique identifier representing the data point.
 
distance:Number — Specifies the distance between the data item on the screen and the location of the mouse pointer, in pixels.
 
x:Number — Specifies the x coordinate of the data item on the screen.
 
y:Number — Specifies the y coordinate of the data item on the screen.
 
chartItem:ChartItem — The chart item described by the hit data.