ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
mx.charts 

HitData  - AS3 Flex

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.

More examples

Related API Elements



Public Properties
 PropertyDefined By
  chartItem : ChartItem
The chart item described by the hit data.
HitData
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  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
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Property Detail

chartItem

property
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.

contextColor

property 
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.

dataTipFunction

property 
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.

displayText

property 
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

distance

property 
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.

element

property 
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

id

property 
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.

item

property 
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.

x

property 
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.

y

property 
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.