## org.jfree.chart.entity
Class ChartEntity

    java.lang.Object
      org.jfree.chart.entity.ChartEntity

All Implemented Interfaces:
  java.io.Serializable, java.lang.Cloneable, org.jfree.util.PublicCloneable

Direct Known Subclasses:
  CategoryItemEntity, ContourEntity, LegendItemEntity, PieSectionEntity, TickLabelEntity, XYAnnotationEntity, XYItemEntity

    public class ChartEntity

extends java.lang.Object
implements java.lang.Cloneable, org.jfree.util.PublicCloneable, java.io.Serializable

A class that captures information about some component of a chart (a bar, line etc).

See Also:
  Serialized Form

Constructor Summary
`ChartEntity(java.awt.Shape area)` Creates a new chart entity.
`ChartEntity(java.awt.Shape area, java.lang.String toolTipText)` Creates a new chart entity.
`ChartEntity(java.awt.Shape area, java.lang.String toolTipText, java.lang.String urlText)` Creates a new entity.

Method Summary
`java.lang.Object` `clone()` Returns a clone of the entity.
`boolean` `equals(java.lang.Object obj)` Tests the entity for equality with an arbitrary object.
`java.awt.Shape` `getArea()` Returns the area occupied by the entity (in Java 2D space).
`java.lang.String` `getImageMapAreaTag(ToolTipTagFragmentGenerator toolTipTagFragmentGenerator, URLTagFragmentGenerator urlTagFragmentGenerator)` Returns an HTML image map tag for this entity.
`java.lang.String` `getShapeCoords()` Returns the shape coordinates as a string.
`java.lang.String` `getShapeType()` Returns a string describing the entity area.
`java.lang.String` `getToolTipText()` Returns the tool tip text for the entity.
`java.lang.String` `getURLText()` Returns the URL text for the entity.
`int` `hashCode()` Returns a hash code for this instance.
`void` `setArea(java.awt.Shape area)` Sets the area for the entity.
`void` `setToolTipText(java.lang.String text)` Sets the tool tip text.
`void` `setURLText(java.lang.String text)` Sets the URL text.
`java.lang.String` `toString()` Returns a string representation of the chart entity, useful for debugging.

Methods inherited from class java.lang.Object
`finalize, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### ChartEntity

    public ChartEntity(java.awt.Shape area)

  Creates a new chart entity.

  Parameters:
    `area` - the area (`null` not permitted).

### ChartEntity

    public ChartEntity(java.awt.Shape area,
                       java.lang.String toolTipText)

  Creates a new chart entity.

  Parameters:
    `area` - the area (`null` not permitted).
    `toolTipText` - the tool tip text (`null` permitted).

### ChartEntity

    public ChartEntity(java.awt.Shape area,
                       java.lang.String toolTipText,
                       java.lang.String urlText)

  Creates a new entity.

  Parameters:
    `area` - the area (`null` not permitted).
    `toolTipText` - the tool tip text (`null` permitted).
    `urlText` - the URL text for HTML image maps (`null` permitted).

Method Detail

### getArea

    public java.awt.Shape getArea()

  Returns the area occupied by the entity (in Java 2D space).

  Returns:
    The area (never `null`).

### setArea

    public void setArea(java.awt.Shape area)

  Sets the area for the entity.

  This class conveys information about chart entities back to a client. Setting this area doesn't change the entity (which has already been drawn).

  Parameters:
    `area` - the area (`null` not permitted).

### getToolTipText

    public java.lang.String getToolTipText()

  Returns the tool tip text for the entity. Be aware that this text may have been generated from user supplied data, so for security reasons some form of filtering should be applied before incorporating this text into any HTML output.

  Returns:
    The tool tip text (possibly `null`).

### setToolTipText

    public void setToolTipText(java.lang.String text)

  Sets the tool tip text.

  Parameters:
    `text` - the text (`null` permitted).

### getURLText

    public java.lang.String getURLText()

  Returns the URL text for the entity. Be aware that this text may have been generated from user supplied data, so some form of filtering should be applied before this "URL" is used in any output.

  Returns:
    The URL text (possibly `null`).

### setURLText

    public void setURLText(java.lang.String text)

  Sets the URL text.

  Parameters:
    `text` - the text (`null` permitted).

### getShapeType

    public java.lang.String getShapeType()

  Returns a string describing the entity area. This string is intended for use in an AREA tag when generating an image map.

  Returns:
    The shape type (never `null`).

### getShapeCoords

    public java.lang.String getShapeCoords()

  Returns the shape coordinates as a string.

  Returns:
    The shape coordinates (never `null`).

### getImageMapAreaTag

    public java.lang.String getImageMapAreaTag(ToolTipTagFragmentGenerator toolTipTagFragmentGenerator,
                                               URLTagFragmentGenerator urlTagFragmentGenerator)

  Returns an HTML image map tag for this entity. The returned fragment should be `XHTML 1.0` compliant.

  Parameters:
    `toolTipTagFragmentGenerator` - a generator for the HTML fragment that will contain the tooltip text (`null` not permitted if this entity contains tooltip information).
    `urlTagFragmentGenerator` - a generator for the HTML fragment that will contain the URL reference (`null` not permitted if this entity has a URL).
  Returns:
    The HTML tag.

### toString

    public java.lang.String toString()

  Returns a string representation of the chart entity, useful for debugging.

  Overrides:
    `toString` in class `java.lang.Object`
  Returns:
    A string.

### equals

    public boolean equals(java.lang.Object obj)

  Tests the entity for equality with an arbitrary object.

  Overrides:
    `equals` in class `java.lang.Object`
  Parameters:
    `obj` - the object to test against (`null` permitted).
  Returns:
    A boolean.

### hashCode

    public int hashCode()

  Returns a hash code for this instance.

  Overrides:
    `hashCode` in class `java.lang.Object`
  Returns:
    A hash code.

### clone

    public java.lang.Object clone()
                           throws java.lang.CloneNotSupportedException

  Returns a clone of the entity.

  Specified by:
    `clone` in interface `org.jfree.util.PublicCloneable`
  Overrides:
    `clone` in class `java.lang.Object`
  Returns:
    A clone.
  Throws:
    `java.lang.CloneNotSupportedException` - if there is a problem cloning the entity.