|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.jrefinery.chart.JFreeChart
A chart class implemented using the Java 2D APIs. The current version supports bar charts, line charts, pie charts and xy plots (including time series data).
JFreeChart coordinates several objects to achieve its aim of being able to draw a chart on a Java 2D graphics device: a Title, a Legend, a Plot and a Dataset (the Plot in turn manages a horizontal axis and a vertical axis).
You should use ChartPanel to display a chart in a GUI.
The ChartFactory class contains static methods for creating 'ready-made' charts.
ChartPanel
,
ChartFactory
,
AbstractTitle
,
Legend
,
Plot
Field Summary | |
static com.jrefinery.ui.about.ProjectInfo |
INFO
Information about the project. |
Fields inherited from interface com.jrefinery.chart.JFreeChartConstants |
DEFAULT_BACKGROUND_IMAGE, DEFAULT_BACKGROUND_IMAGE_ALPHA, DEFAULT_BACKGROUND_PAINT, DEFAULT_TITLE_FONT |
Constructor Summary | |
JFreeChart(Plot plot)
Constructs a chart. |
|
JFreeChart(java.lang.String title,
java.awt.Font titleFont,
Plot plot,
boolean createLegend)
Constructs a chart. |
Method Summary | |
void |
addChangeListener(ChartChangeListener listener)
Registers an object for notification of changes to the chart. |
void |
addTitle(AbstractTitle title)
Adds the chart title, and notifies registered listeners that the chart has been modified. |
java.awt.image.BufferedImage |
createBufferedImage(int width,
int height)
Creates and returns a buffered image into which the chart has been drawn. |
java.awt.image.BufferedImage |
createBufferedImage(int width,
int height,
ChartRenderingInfo info)
Creates and returns a buffered image into which the chart has been drawn. |
void |
draw(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D area)
Draws the chart on a Java 2D graphics device (such as the screen or a printer). |
void |
draw(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D chartArea,
ChartRenderingInfo info)
Draws the chart on a Java 2D graphics device (such as the screen or a printer). |
protected void |
fireChartChanged()
Sends a default ChartChangeEvent to all registered listeners. |
boolean |
getAntiAlias()
Returns a flag that indicates whether or not anti-aliasing is used when the chart is drawn. |
java.awt.Image |
getBackgroundImage()
Returns the chart's background image (possibly null). |
float |
getBackgroundImageAlpha()
Returns the alpha-transparency for the chart's background image. |
java.awt.Paint |
getBackgroundPaint()
Returns the color/shade used to fill the chart background. |
CategoryPlot |
getCategoryPlot()
Returns the plot cast as a CategoryPlot. |
Legend |
getLegend()
Returns the chart legend. |
Plot |
getPlot()
Returns the plot for the chart. |
AbstractTitle |
getTitle(int index)
Returns a chart title. |
int |
getTitleCount()
Returns the number of titles for the chart. |
java.util.List |
getTitles()
Returns a reference to the list of titles. |
XYPlot |
getXYPlot()
Returns the plot cast as an XYPlot. |
void |
handleClick(int x,
int y,
ChartRenderingInfo info)
Handles a 'click' on the chart. |
void |
legendChanged(LegendChangeEvent event)
Receives notification that the chart legend has changed, and passes this on to registered listeners. |
static void |
main(java.lang.String[] args)
Prints information about JFreeChart to standard output. |
protected void |
notifyListeners(ChartChangeEvent event)
Sends a ChartChangeEvent to all registered listeners. |
void |
plotChanged(PlotChangeEvent event)
Receives notification that the plot has changed, and passes this on to registered listeners. |
void |
removeChangeListener(ChartChangeListener listener)
Deregisters an object for notification of changes to the chart. |
void |
setAntiAlias(boolean flag)
Sets a flag that indicates whether or not anti-aliasing is used when the chart is drawn. |
void |
setBackgroundImage(java.awt.Image image)
Sets the chart's background image (null permitted). |
void |
setBackgroundImageAlpha(float alpha)
Sets the alpha-transparency for the chart's background image. |
void |
setBackgroundPaint(java.awt.Paint paint)
Sets the color/shade used to fill the chart background. |
void |
setLegend(Legend legend)
Sets the chart legend. |
void |
setTitles(java.util.List titles)
Sets the title list for the chart (completely replaces any existing titles). |
void |
titleChanged(TitleChangeEvent event)
Receives notification that a chart title has changed, and passes this on to registered listeners. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final com.jrefinery.ui.about.ProjectInfo INFO
Constructor Detail |
public JFreeChart(Plot plot)
Note that the ChartFactory class contains static methods that will return a ready-made chart.
plot
- controller of the visual representation of the data.public JFreeChart(java.lang.String title, java.awt.Font titleFont, Plot plot, boolean createLegend)
Note that the ChartFactory class contains static methods that will return a ready-made chart.
title
- the main chart title.titleFont
- the font for displaying the chart title.plot
- controller of the visual representation of the data.createLegend
- a flag indicating whether or not a legend should
be created for the chart.Method Detail |
public java.util.List getTitles()
public void setTitles(java.util.List titles)
titles
- the new list of titles.public int getTitleCount()
public AbstractTitle getTitle(int index)
index
- the index of the chart title (zero based).public void addTitle(AbstractTitle title)
title
- the chart title.public Legend getLegend()
public void setLegend(Legend legend)
legend
- the new chart legend (null permitted).public Plot getPlot()
public CategoryPlot getCategoryPlot()
public XYPlot getXYPlot()
public boolean getAntiAlias()
public void setAntiAlias(boolean flag)
Anti-aliasing usually improves the appearance of charts.
flag
- the new value of the flag.public java.awt.Paint getBackgroundPaint()
public void setBackgroundPaint(java.awt.Paint paint)
paint
- the new background color/shade.public java.awt.Image getBackgroundImage()
public void setBackgroundImage(java.awt.Image image)
image
- the image.public float getBackgroundImageAlpha()
public void setBackgroundImageAlpha(float alpha)
alpha
- the alpha value.public void draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area)
This method is the focus of the entire JFreeChart library.
draw
in interface com.jrefinery.ui.Drawable
g2
- the graphics device.area
- the area within which the chart should be drawn.public void draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D chartArea, ChartRenderingInfo info)
This method is the focus of the entire JFreeChart library.
g2
- the graphics device.chartArea
- the area within which the chart should be drawn.info
- records info about the drawing (null means collect no info).public java.awt.image.BufferedImage createBufferedImage(int width, int height)
width
- the width.height
- the height.public java.awt.image.BufferedImage createBufferedImage(int width, int height, ChartRenderingInfo info)
width
- the width.height
- the height.info
- optional object for collection chart dimension and entity information.public void handleClick(int x, int y, ChartRenderingInfo info)
JFreeChart is not a UI component, so some other object (e.g. ChartPanel) needs to capture the click event and pass it onto the JFreeChart object. If you are not using JFreeChart in a client application, then this method is not required (and hopefully it doesn't get in the way).
x
- x-coordinate of the click.y
- y-coordinate of the click.info
- optional object for collection chart dimension and entity information.public void addChangeListener(ChartChangeListener listener)
listener
- the object being registered.public void removeChangeListener(ChartChangeListener listener)
listener
- the object being deregistered.protected void fireChartChanged()
This method is for convenience only.
protected void notifyListeners(ChartChangeEvent event)
event
- information about the event that triggered the notification.public void titleChanged(TitleChangeEvent event)
titleChanged
in interface TitleChangeListener
event
- information about the chart title change.public void legendChanged(LegendChangeEvent event)
legendChanged
in interface LegendChangeListener
event
- information about the chart legend change.public void plotChanged(PlotChangeEvent event)
plotChanged
in interface PlotChangeListener
event
- information about the plot change.public static void main(java.lang.String[] args)
args
- no arguments are honored.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |