- java.lang.Object
-
- org.jfree.chart.JFreeChart
-
- All Implemented Interfaces:
Serializable,Cloneable,EventListener,ChartElement,Drawable,PlotChangeListener,TitleChangeListener
public class JFreeChart extends Object implements Drawable, TitleChangeListener, PlotChangeListener, ChartElement, Serializable, Cloneable
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 list of
Titleobjects (which often includes the chart's legend), aPlotand aDataset(the plot in turn manages a domain axis and a range axis).You should use a
ChartPanelto display a chart in a GUI.The
ChartFactoryclass contains static methods for creating 'ready-made' charts.- See Also:
ChartPanel,ChartFactory,Title,Plot, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static ImageDEFAULT_BACKGROUND_IMAGEThe default background image.static RectangleAlignmentDEFAULT_BACKGROUND_IMAGE_ALIGNMENTThe default background image alignment.static floatDEFAULT_BACKGROUND_IMAGE_ALPHAThe default background image alpha.static PaintDEFAULT_BACKGROUND_PAINTThe default background color.static FontDEFAULT_TITLE_FONTThe default font for titles.static RenderingHints.KeyKEY_SUPPRESS_SHADOW_GENERATIONThe key for a rendering hint that can suppress the generation of a shadow effect when drawing the chart.
-
Constructor Summary
Constructors Constructor Description JFreeChart(String title, Font titleFont, Plot plot, boolean createLegend)Creates a new chart with the given title and plot.JFreeChart(String title, Plot plot)Creates a new chart with the given title and plot.JFreeChart(Plot plot)Creates a new chart based on the supplied plot.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddChangeListener(ChartChangeListener listener)Registers an object for notification of changes to the chart.voidaddLegend(org.jfree.chart.legend.LegendTitle legend)Adds a legend to the plot and sends aChartChangeEventto all registered listeners.voidaddProgressListener(ChartProgressListener listener)Registers an object for notification of progress events relating to the chart.voidaddSubtitle(int index, Title subtitle)Adds a subtitle at a particular position in the subtitle list, and sends aChartChangeEventto all registered listeners.voidaddSubtitle(Title subtitle)Adds a chart subtitle, and notifies registered listeners that the chart has been modified.voidclearSubtitles()Clears all subtitles from the chart and sends aChartChangeEventto all registered listeners.Objectclone()Clones the object, and takes care of listeners.BufferedImagecreateBufferedImage(int width, int height)Creates and returns a buffered image into which the chart has been drawn.BufferedImagecreateBufferedImage(int imageWidth, int imageHeight, double drawWidth, double drawHeight, ChartRenderingInfo info)Creates and returns a buffered image into which the chart has been drawn.BufferedImagecreateBufferedImage(int width, int height, int imageType, ChartRenderingInfo info)Creates and returns a buffered image into which the chart has been drawn.BufferedImagecreateBufferedImage(int width, int height, ChartRenderingInfo info)Creates and returns a buffered image into which the chart has been drawn.voiddraw(Graphics2D g2, Rectangle2D area)Draws the chart on a Java 2D graphics device (such as the screen or a printer).voiddraw(Graphics2D g2, Rectangle2D chartArea, Point2D anchor, ChartRenderingInfo info)Draws the chart on a Java 2D graphics device (such as the screen or a printer).voiddraw(Graphics2D g2, Rectangle2D area, ChartRenderingInfo info)Draws the chart on a Java 2D graphics device (such as the screen or a printer).protected EntityCollectiondrawTitle(Title t, Graphics2D g2, Rectangle2D area, boolean entities)Draws a title.booleanequals(Object obj)Tests this chart for equality with another object.voidfireChartChanged()Sends a defaultChartChangeEventto all registered listeners.booleangetAntiAlias()Returns a flag that indicates whether or not anti-aliasing is used when the chart is drawn.ImagegetBackgroundImage()Returns the background image for the chart, ornullif there is no image.RectangleAlignmentgetBackgroundImageAlignment()Returns the background image alignment.floatgetBackgroundImageAlpha()Returns the alpha-transparency for the chart's background image.PaintgetBackgroundPaint()Returns the paint used for the chart background.PaintgetBorderPaint()Returns the paint used to draw the chart border (if visible).StrokegetBorderStroke()Returns the stroke used to draw the chart border (if visible).booleangetElementHinting()Returns the flag that controls whether or not rendering hints (ChartHints.KEY_BEGIN_ELEMENTandChartHints.KEY_END_ELEMENT) that identify chart elements are added during rendering.StringgetID()Returns the ID for the chart.org.jfree.chart.legend.LegendTitlegetLegend()Returns the legend for the chart, if there is one.org.jfree.chart.legend.LegendTitlegetLegend(int index)Returns the nth legend for a chart, ornull.RectangleInsetsgetPadding()Returns the padding between the chart border and the chart drawing area.PlotgetPlot()Returns the plot for the chart.RenderingHintsgetRenderingHints()Returns the collection of rendering hints for the chart.TitlegetSubtitle(int index)Returns a chart subtitle.intgetSubtitleCount()Returns the number of titles for the chart.List<Title>getSubtitles()Returns a new list containing all the subtitles for the chart.ObjectgetTextAntiAlias()Returns the current value stored in the rendering hints table forRenderingHints.KEY_TEXT_ANTIALIASING.TextTitlegetTitle()Returns the main chart title.voidhandleClick(int x, int y, ChartRenderingInfo info)Handles a 'click' on the chart.inthashCode()booleanisBorderVisible()Returns a flag that controls whether or not a border is drawn around the outside of the chart.booleanisNotify()Returns a flag that controls whether or not change events are sent to registered listeners.protected voidnotifyListeners(ChartChangeEvent event)Sends aChartChangeEventto all registered listeners.protected voidnotifyListeners(ChartProgressEvent event)Sends aChartProgressEventto all registered listeners.voidplotChanged(PlotChangeEvent event)Receives notification that the plot has changed, and passes this on to registered listeners.voidreceive(ChartElementVisitor visitor)Receives a visitor to the element.voidremoveChangeListener(ChartChangeListener listener)Deregisters an object for notification of changes to the chart.voidremoveLegend()Removes the first legend in the chart and sends aChartChangeEventto all registered listeners.voidremoveProgressListener(ChartProgressListener listener)Deregisters an object for notification of changes to the chart.voidremoveSubtitle(Title title)Removes the specified subtitle and sends aChartChangeEventto all registered listeners.voidsetAntiAlias(boolean flag)Sets a flag that indicates whether or not anti-aliasing is used when the chart is drawn.voidsetBackgroundImage(Image image)Sets the background image for the chart and sends aChartChangeEventto all registered listeners.voidsetBackgroundImageAlignment(RectangleAlignment alignment)Sets the background alignment and sends a change notification to all registered listeners.voidsetBackgroundImageAlpha(float alpha)Sets the alpha-transparency for the chart's background image.voidsetBackgroundPaint(Paint paint)Sets the paint used to fill the chart background and sends aChartChangeEventto all registered listeners.voidsetBorderPaint(Paint paint)Sets the paint used to draw the chart border (if visible).voidsetBorderStroke(Stroke stroke)Sets the stroke used to draw the chart border (if visible).voidsetBorderVisible(boolean visible)Sets a flag that controls whether or not a border is drawn around the outside of the chart.voidsetElementHinting(boolean hinting)Sets the flag that controls whether or not rendering hints (ChartHints.KEY_BEGIN_ELEMENTandChartHints.KEY_END_ELEMENT) that identify chart elements are added during rendering.voidsetID(String id)Sets the ID for the chart.voidsetNotify(boolean notify)Sets a flag that controls whether or not listeners receiveChartChangeEventnotifications.voidsetPadding(RectangleInsets padding)Sets the padding between the chart border and the chart drawing area, and sends aChartChangeEventto all registered listeners.voidsetRenderingHints(RenderingHints renderingHints)Sets the rendering hints for the chart.voidsetSubtitles(List<Title> subtitles)Sets the title list for the chart (completely replaces any existing titles) and sends aChartChangeEventto all registered listeners.voidsetTextAntiAlias(boolean flag)Sets the value in the rendering hints table forRenderingHints.KEY_TEXT_ANTIALIASINGto eitherRenderingHints.VALUE_TEXT_ANTIALIAS_ONorRenderingHints.VALUE_TEXT_ANTIALIAS_OFF, then sends aChartChangeEventto all registered listeners.voidsetTextAntiAlias(Object val)Sets the value in the rendering hints table forRenderingHints.KEY_TEXT_ANTIALIASINGand sends aChartChangeEventto all registered listeners.voidsetTitle(String text)Sets the chart title and sends aChartChangeEventto all registered listeners.voidsetTitle(TextTitle title)Sets the main title for the chart and sends aChartChangeEventto all registered listeners.voidtitleChanged(TitleChangeEvent event)Receives notification that a chart title has changed, and passes this on to registered listeners.
-
-
-
Field Detail
-
DEFAULT_TITLE_FONT
public static final Font DEFAULT_TITLE_FONT
The default font for titles.
-
DEFAULT_BACKGROUND_PAINT
public static final Paint DEFAULT_BACKGROUND_PAINT
The default background color.
-
DEFAULT_BACKGROUND_IMAGE
public static final Image DEFAULT_BACKGROUND_IMAGE
The default background image.
-
DEFAULT_BACKGROUND_IMAGE_ALIGNMENT
public static final RectangleAlignment DEFAULT_BACKGROUND_IMAGE_ALIGNMENT
The default background image alignment.
-
DEFAULT_BACKGROUND_IMAGE_ALPHA
public static final float DEFAULT_BACKGROUND_IMAGE_ALPHA
The default background image alpha.- See Also:
- Constant Field Values
-
KEY_SUPPRESS_SHADOW_GENERATION
public static final RenderingHints.Key KEY_SUPPRESS_SHADOW_GENERATION
The key for a rendering hint that can suppress the generation of a shadow effect when drawing the chart. The hint value must be a Boolean.
-
-
Constructor Detail
-
JFreeChart
public JFreeChart(Plot plot)
Creates a new chart based on the supplied plot. The chart will have a legend added automatically, but no title (although you can easily add one later).
Note that theChartFactoryclass contains a range of static methods that will return ready-made charts, and often this is a more convenient way to create charts than using this constructor.- Parameters:
plot- the plot (nullnot permitted).
-
JFreeChart
public JFreeChart(String title, Plot plot)
Creates a new chart with the given title and plot. A default font (DEFAULT_TITLE_FONT) is used for the title, and the chart will have a legend added automatically.
Note that theChartFactoryclass contains a range of static methods that will return ready-made charts, and often this is a more convenient way to create charts than using this constructor.- Parameters:
title- the chart title (nullpermitted).plot- the plot (nullnot permitted).
-
JFreeChart
public JFreeChart(String title, Font titleFont, Plot plot, boolean createLegend)
Creates a new chart with the given title and plot. ThecreateLegendargument specifies whether or not a legend should be added to the chart.
Note that theChartFactoryclass contains a range of static methods that will return ready-made charts, and often this is a more convenient way to create charts than using this constructor.- Parameters:
title- the chart title (nullpermitted).titleFont- the font for displaying the chart title (nullpermitted).plot- controller of the visual representation of the data (nullnot permitted).createLegend- a flag indicating whether or not a legend should be created for the chart.
-
-
Method Detail
-
getID
public String getID()
Returns the ID for the chart.- Returns:
- The ID for the chart (possibly
null).
-
setID
public void setID(String id)
Sets the ID for the chart.- Parameters:
id- the id (nullpermitted).
-
getElementHinting
public boolean getElementHinting()
Returns the flag that controls whether or not rendering hints (ChartHints.KEY_BEGIN_ELEMENTandChartHints.KEY_END_ELEMENT) that identify chart elements are added during rendering. The default value isfalse.- Returns:
- A boolean.
- See Also:
setElementHinting(boolean)
-
setElementHinting
public void setElementHinting(boolean hinting)
Sets the flag that controls whether or not rendering hints (ChartHints.KEY_BEGIN_ELEMENTandChartHints.KEY_END_ELEMENT) that identify chart elements are added during rendering.- Parameters:
hinting- the new flag value.- See Also:
getElementHinting()
-
getRenderingHints
public RenderingHints getRenderingHints()
Returns the collection of rendering hints for the chart.- Returns:
- The rendering hints for the chart (never
null). - See Also:
setRenderingHints(RenderingHints)
-
setRenderingHints
public void setRenderingHints(RenderingHints renderingHints)
Sets the rendering hints for the chart. These will be added (using theGraphics2D.addRenderingHints()method) near the start of theJFreeChart.draw()method.- Parameters:
renderingHints- the rendering hints (nullnot permitted).- See Also:
getRenderingHints()
-
isBorderVisible
public boolean isBorderVisible()
Returns a flag that controls whether or not a border is drawn around the outside of the chart.- Returns:
- A boolean.
- See Also:
setBorderVisible(boolean)
-
setBorderVisible
public void setBorderVisible(boolean visible)
Sets a flag that controls whether or not a border is drawn around the outside of the chart.- Parameters:
visible- the flag.- See Also:
isBorderVisible()
-
getBorderStroke
public Stroke getBorderStroke()
Returns the stroke used to draw the chart border (if visible).- Returns:
- The border stroke.
- See Also:
setBorderStroke(Stroke)
-
setBorderStroke
public void setBorderStroke(Stroke stroke)
Sets the stroke used to draw the chart border (if visible).- Parameters:
stroke- the stroke.- See Also:
getBorderStroke()
-
getBorderPaint
public Paint getBorderPaint()
Returns the paint used to draw the chart border (if visible).- Returns:
- The border paint.
- See Also:
setBorderPaint(Paint)
-
setBorderPaint
public void setBorderPaint(Paint paint)
Sets the paint used to draw the chart border (if visible).- Parameters:
paint- the paint.- See Also:
getBorderPaint()
-
getPadding
public RectangleInsets getPadding()
Returns the padding between the chart border and the chart drawing area.- Returns:
- The padding (never
null). - See Also:
setPadding(RectangleInsets)
-
setPadding
public void setPadding(RectangleInsets padding)
Sets the padding between the chart border and the chart drawing area, and sends aChartChangeEventto all registered listeners.- Parameters:
padding- the padding (nullnot permitted).- See Also:
getPadding()
-
getTitle
public TextTitle getTitle()
Returns the main chart title. Very often a chart will have just one title, so we make this case simple by providing accessor methods for the main title. However, multiple titles are supported - see theaddSubtitle(Title)method.- Returns:
- The chart title (possibly
null). - See Also:
setTitle(TextTitle)
-
setTitle
public void setTitle(TextTitle title)
Sets the main title for the chart and sends aChartChangeEventto all registered listeners. If you do not want a title for the chart, set it tonull. If you want more than one title on a chart, use theaddSubtitle(Title)method.- Parameters:
title- the title (nullpermitted).- See Also:
getTitle()
-
setTitle
public void setTitle(String text)
Sets the chart title and sends aChartChangeEventto all registered listeners. This is a convenience method that ends up calling thesetTitle(TextTitle)method. If there is an existing title, its text is updated, otherwise a new title using the default font is added to the chart. Iftextisnullthe chart title is set tonull.- Parameters:
text- the title text (nullpermitted).- See Also:
getTitle()
-
addLegend
public void addLegend(org.jfree.chart.legend.LegendTitle legend)
Adds a legend to the plot and sends aChartChangeEventto all registered listeners.- Parameters:
legend- the legend (nullnot permitted).- See Also:
removeLegend()
-
getLegend
public org.jfree.chart.legend.LegendTitle getLegend()
Returns the legend for the chart, if there is one. Note that a chart can have more than one legend - this method returns the first.- Returns:
- The legend (possibly
null). - See Also:
getLegend(int)
-
getLegend
public org.jfree.chart.legend.LegendTitle getLegend(int index)
Returns the nth legend for a chart, ornull.- Parameters:
index- the legend index (zero-based).- Returns:
- The legend (possibly
null). - See Also:
addLegend(LegendTitle)
-
removeLegend
public void removeLegend()
Removes the first legend in the chart and sends aChartChangeEventto all registered listeners.- See Also:
getLegend()
-
getSubtitles
public List<Title> getSubtitles()
Returns a new list containing all the subtitles for the chart.- Returns:
- The subtitle list (possibly empty, but never
null). - See Also:
setSubtitles(List)
-
setSubtitles
public void setSubtitles(List<Title> subtitles)
Sets the title list for the chart (completely replaces any existing titles) and sends aChartChangeEventto all registered listeners.- Parameters:
subtitles- the new list of subtitles (nullnot permitted).- See Also:
getSubtitles()
-
getSubtitleCount
public int getSubtitleCount()
Returns the number of titles for the chart.- Returns:
- The number of titles for the chart.
- See Also:
getSubtitles()
-
getSubtitle
public Title getSubtitle(int index)
Returns a chart subtitle.- Parameters:
index- the index of the chart subtitle (zero based).- Returns:
- A chart subtitle.
- See Also:
addSubtitle(Title)
-
addSubtitle
public void addSubtitle(Title subtitle)
Adds a chart subtitle, and notifies registered listeners that the chart has been modified.- Parameters:
subtitle- the subtitle (nullnot permitted).- See Also:
getSubtitle(int)
-
addSubtitle
public void addSubtitle(int index, Title subtitle)
Adds a subtitle at a particular position in the subtitle list, and sends aChartChangeEventto all registered listeners.- Parameters:
index- the index (in the range 0 togetSubtitleCount()).subtitle- the subtitle to add (nullnot permitted).
-
clearSubtitles
public void clearSubtitles()
Clears all subtitles from the chart and sends aChartChangeEventto all registered listeners.- See Also:
addSubtitle(Title)
-
removeSubtitle
public void removeSubtitle(Title title)
Removes the specified subtitle and sends aChartChangeEventto all registered listeners.- Parameters:
title- the title.- See Also:
addSubtitle(Title)
-
getPlot
public Plot getPlot()
Returns the plot for the chart. The plot is a class responsible for coordinating the visual representation of the data, including the axes (if any).- Returns:
- The plot.
-
getAntiAlias
public boolean getAntiAlias()
Returns a flag that indicates whether or not anti-aliasing is used when the chart is drawn.- Returns:
- The flag.
- See Also:
setAntiAlias(boolean)
-
setAntiAlias
public void setAntiAlias(boolean flag)
Sets a flag that indicates whether or not anti-aliasing is used when the chart is drawn.Anti-aliasing usually improves the appearance of charts, but is slower.
- Parameters:
flag- the new value of the flag.- See Also:
getAntiAlias()
-
getTextAntiAlias
public Object getTextAntiAlias()
Returns the current value stored in the rendering hints table forRenderingHints.KEY_TEXT_ANTIALIASING.- Returns:
- The hint value (possibly
null). - See Also:
setTextAntiAlias(Object)
-
setTextAntiAlias
public void setTextAntiAlias(boolean flag)
Sets the value in the rendering hints table forRenderingHints.KEY_TEXT_ANTIALIASINGto eitherRenderingHints.VALUE_TEXT_ANTIALIAS_ONorRenderingHints.VALUE_TEXT_ANTIALIAS_OFF, then sends aChartChangeEventto all registered listeners.- Parameters:
flag- the new value of the flag.- See Also:
getTextAntiAlias(),setTextAntiAlias(Object)
-
setTextAntiAlias
public void setTextAntiAlias(Object val)
Sets the value in the rendering hints table forRenderingHints.KEY_TEXT_ANTIALIASINGand sends aChartChangeEventto all registered listeners.- Parameters:
val- the new value (nullpermitted).- See Also:
getTextAntiAlias(),setTextAntiAlias(boolean)
-
getBackgroundPaint
public Paint getBackgroundPaint()
Returns the paint used for the chart background.- Returns:
- The paint (possibly
null). - See Also:
setBackgroundPaint(Paint)
-
setBackgroundPaint
public void setBackgroundPaint(Paint paint)
Sets the paint used to fill the chart background and sends aChartChangeEventto all registered listeners.- Parameters:
paint- the paint (nullpermitted).- See Also:
getBackgroundPaint()
-
getBackgroundImage
public Image getBackgroundImage()
Returns the background image for the chart, ornullif there is no image.- Returns:
- The image (possibly
null). - See Also:
setBackgroundImage(Image)
-
setBackgroundImage
public void setBackgroundImage(Image image)
Sets the background image for the chart and sends aChartChangeEventto all registered listeners.- Parameters:
image- the image (nullpermitted).- See Also:
getBackgroundImage()
-
getBackgroundImageAlignment
public RectangleAlignment getBackgroundImageAlignment()
Returns the background image alignment.- Returns:
- The alignment (never
null). - See Also:
setBackgroundImageAlignment(RectangleAlignment)
-
setBackgroundImageAlignment
public void setBackgroundImageAlignment(RectangleAlignment alignment)
Sets the background alignment and sends a change notification to all registered listeners.- Parameters:
alignment- the alignment (nullnot permitted).- See Also:
getBackgroundImageAlignment()
-
getBackgroundImageAlpha
public float getBackgroundImageAlpha()
Returns the alpha-transparency for the chart's background image.- Returns:
- The alpha-transparency.
- See Also:
setBackgroundImageAlpha(float)
-
setBackgroundImageAlpha
public void setBackgroundImageAlpha(float alpha)
Sets the alpha-transparency for the chart's background image. Registered listeners are notified that the chart has been changed.- Parameters:
alpha- the alpha value.- See Also:
getBackgroundImageAlpha()
-
isNotify
public boolean isNotify()
Returns a flag that controls whether or not change events are sent to registered listeners.- Returns:
- A boolean.
- See Also:
setNotify(boolean)
-
setNotify
public void setNotify(boolean notify)
Sets a flag that controls whether or not listeners receiveChartChangeEventnotifications.- Parameters:
notify- a boolean.- See Also:
isNotify()
-
receive
public void receive(ChartElementVisitor visitor)
Description copied from interface:ChartElementReceives a visitor to the element.- Specified by:
receivein interfaceChartElement- Parameters:
visitor- the visitor (nullnot permitted).
-
draw
public void draw(Graphics2D g2, Rectangle2D area)
Draws the chart on a Java 2D graphics device (such as the screen or a printer).This method is the focus of the entire JFreeChart library.
-
draw
public void draw(Graphics2D g2, Rectangle2D area, ChartRenderingInfo info)
Draws the chart on a Java 2D graphics device (such as the screen or a printer). This method is the focus of the entire JFreeChart library.- Parameters:
g2- the graphics device.area- the area within which the chart should be drawn.info- records info about the drawing (null means collect no info).
-
draw
public void draw(Graphics2D g2, Rectangle2D chartArea, Point2D anchor, ChartRenderingInfo info)
Draws the chart on a Java 2D graphics device (such as the screen or a printer).This method is the focus of the entire JFreeChart library.
- Parameters:
g2- the graphics device.chartArea- the area within which the chart should be drawn.anchor- the anchor point (in Java2D space) for the chart (nullpermitted).info- records info about the drawing (null means collect no info).
-
drawTitle
protected EntityCollection drawTitle(Title t, Graphics2D g2, Rectangle2D area, boolean entities)
Draws a title. The title should be drawn at the top, bottom, left or right of the specified area, and the area should be updated to reflect the amount of space used by the title.- Parameters:
t- the title (nullnot permitted).g2- the graphics device (nullnot permitted).area- the chart area, excluding any existing titles (nullnot permitted).entities- a flag that controls whether or not an entity collection is returned for the title.- Returns:
- An entity collection for the title (possibly
null).
-
createBufferedImage
public BufferedImage createBufferedImage(int width, int height)
Creates and returns a buffered image into which the chart has been drawn.- Parameters:
width- the width.height- the height.- Returns:
- A buffered image.
-
createBufferedImage
public BufferedImage createBufferedImage(int width, int height, ChartRenderingInfo info)
Creates and returns a buffered image into which the chart has been drawn.- Parameters:
width- the width.height- the height.info- carries back chart state information (nullpermitted).- Returns:
- A buffered image.
-
createBufferedImage
public BufferedImage createBufferedImage(int width, int height, int imageType, ChartRenderingInfo info)
Creates and returns a buffered image into which the chart has been drawn.- Parameters:
width- the width.height- the height.imageType- the image type.info- carries back chart state information (nullpermitted).- Returns:
- A buffered image.
-
createBufferedImage
public BufferedImage createBufferedImage(int imageWidth, int imageHeight, double drawWidth, double drawHeight, ChartRenderingInfo info)
Creates and returns a buffered image into which the chart has been drawn.- Parameters:
imageWidth- the image width.imageHeight- the image height.drawWidth- the width for drawing the chart (will be scaled to fit image).drawHeight- the height for drawing the chart (will be scaled to fit image).info- optional object for collection chart dimension and entity information.- Returns:
- A buffered image.
-
handleClick
public void handleClick(int x, int y, ChartRenderingInfo info)
Handles a 'click' on the chart. JFreeChart is not a UI component, so some other object (for example,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.- Parameters:
x- x-coordinate of the click (in Java2D space).y- y-coordinate of the click (in Java2D space).info- contains chart dimension and entity information (nullnot permitted).
-
addChangeListener
public void addChangeListener(ChartChangeListener listener)
Registers an object for notification of changes to the chart.- Parameters:
listener- the listener (nullnot permitted).- See Also:
removeChangeListener(ChartChangeListener)
-
removeChangeListener
public void removeChangeListener(ChartChangeListener listener)
Deregisters an object for notification of changes to the chart.- Parameters:
listener- the listener (nullnot permitted)- See Also:
addChangeListener(ChartChangeListener)
-
fireChartChanged
public void fireChartChanged()
Sends a defaultChartChangeEventto all registered listeners.This method is for convenience only.
-
notifyListeners
protected void notifyListeners(ChartChangeEvent event)
Sends aChartChangeEventto all registered listeners.- Parameters:
event- information about the event that triggered the notification.
-
addProgressListener
public void addProgressListener(ChartProgressListener listener)
Registers an object for notification of progress events relating to the chart.- Parameters:
listener- the object being registered.- See Also:
removeProgressListener(ChartProgressListener)
-
removeProgressListener
public void removeProgressListener(ChartProgressListener listener)
Deregisters an object for notification of changes to the chart.- Parameters:
listener- the object being deregistered.- See Also:
addProgressListener(ChartProgressListener)
-
notifyListeners
protected void notifyListeners(ChartProgressEvent event)
Sends aChartProgressEventto all registered listeners.- Parameters:
event- information about the event that triggered the notification.
-
titleChanged
public void titleChanged(TitleChangeEvent event)
Receives notification that a chart title has changed, and passes this on to registered listeners.- Specified by:
titleChangedin interfaceTitleChangeListener- Parameters:
event- information about the chart title change.
-
plotChanged
public void plotChanged(PlotChangeEvent event)
Receives notification that the plot has changed, and passes this on to registered listeners.- Specified by:
plotChangedin interfacePlotChangeListener- Parameters:
event- information about the plot change.
-
clone
public Object clone() throws CloneNotSupportedException
Clones the object, and takes care of listeners. Note: caller shall register its own listeners on cloned graph.- Overrides:
clonein classObject- Returns:
- A clone.
- Throws:
CloneNotSupportedException- if the chart is not cloneable.
-
-