org.jfree.chart.title

Class ImageTitle

public class ImageTitle extends Title

A chart title that displays an image. This is useful, for example, if you have an image of your corporate logo and want to use as a footnote or part of a title in a chart you create.

ImageTitle needs an image passed to it in the constructor. For ImageTitle to work, you must have already loaded this image from its source (disk or URL). It is recomended you use something like Toolkit.getDefaultToolkit().getImage() to get the image. Then, use MediaTracker or some other message to make sure the image is fully loaded from disk.

Constructor Summary
ImageTitle(Image image)
Creates a new image title.
ImageTitle(Image image, RectangleEdge position, HorizontalAlignment horizontalAlignment, VerticalAlignment verticalAlignment)
Creates a new image title.
ImageTitle(Image image, int height, int width, RectangleEdge position, HorizontalAlignment horizontalAlignment, VerticalAlignment verticalAlignment, RectangleInsets padding)
Creates a new image title with the given image scaled to the given width and height in the given location.
Method Summary
voiddraw(Graphics2D g2, Rectangle2D titleArea)
Draws the title on a Java 2D graphics device (such as the screen or a printer).
Objectdraw(Graphics2D g2, Rectangle2D area, Object params)
Draws the block within the specified area.
protected Size2DdrawHorizontal(Graphics2D g2, Rectangle2D chartArea)
Draws the title on a Java 2D graphics device (such as the screen or a printer).
protected Size2DdrawVertical(Graphics2D g2, Rectangle2D chartArea)
Draws the title on a Java 2D graphics device (such as the screen or a printer).
ImagegetImage()
Returns the image for the title.
voidsetImage(Image image)
Sets the image for the title and notifies registered listeners that the title has been modified.

Constructor Detail

ImageTitle

public ImageTitle(Image image)
Creates a new image title.

Parameters: image the image (null not permitted).

ImageTitle

public ImageTitle(Image image, RectangleEdge position, HorizontalAlignment horizontalAlignment, VerticalAlignment verticalAlignment)
Creates a new image title.

Parameters: image the image (null not permitted). position the title position. horizontalAlignment the horizontal alignment. verticalAlignment the vertical alignment.

ImageTitle

public ImageTitle(Image image, int height, int width, RectangleEdge position, HorizontalAlignment horizontalAlignment, VerticalAlignment verticalAlignment, RectangleInsets padding)
Creates a new image title with the given image scaled to the given width and height in the given location.

Parameters: image the image (null not permitted). height the height used to draw the image. width the width used to draw the image. position the title position. horizontalAlignment the horizontal alignment. verticalAlignment the vertical alignment. padding the amount of space to leave around the outside of the title.

Method Detail

draw

public void draw(Graphics2D g2, Rectangle2D titleArea)
Draws the title on a Java 2D graphics device (such as the screen or a printer).

Parameters: g2 the graphics device. titleArea the area within which the title (and plot) should be drawn.

draw

public Object draw(Graphics2D g2, Rectangle2D area, Object params)
Draws the block within the specified area.

Parameters: g2 the graphics device. area the area. params ignored (null permitted).

Returns: Always null.

drawHorizontal

protected Size2D drawHorizontal(Graphics2D g2, Rectangle2D chartArea)
Draws the title on a Java 2D graphics device (such as the screen or a printer).

Parameters: g2 the graphics device. chartArea the area within which the title (and plot) should be drawn.

Returns: The size of the area used by the title.

drawVertical

protected Size2D drawVertical(Graphics2D g2, Rectangle2D chartArea)
Draws the title on a Java 2D graphics device (such as the screen or a printer).

Parameters: g2 the graphics device. chartArea the area within which the title (and plot) should be drawn.

Returns: The size of the area used by the title.

getImage

public Image getImage()
Returns the image for the title.

Returns: The image for the title (never null).

setImage

public void setImage(Image image)
Sets the image for the title and notifies registered listeners that the title has been modified.

Parameters: image the new image (null not permitted).