Package org.jfree.chart.title
Class TextTitle
java.lang.Object
org.jfree.chart.block.AbstractBlock
org.jfree.chart.title.Title
org.jfree.chart.title.TextTitle
- All Implemented Interfaces:
Serializable
,Cloneable
,Block
,Drawable
,PublicCloneable
- Direct Known Subclasses:
DateTitle
,ShortTextTitle
public class TextTitle extends Title implements Serializable, Cloneable, PublicCloneable
A chart title that displays a text string with automatic wrapping as
required.
- See Also:
- Serialized Form
-
Field Summary
Fields Modifier and Type Field Description static Font
DEFAULT_FONT
The default font.static Paint
DEFAULT_TEXT_PAINT
The default text color.Fields inherited from class org.jfree.chart.title.Title
DEFAULT_HORIZONTAL_ALIGNMENT, DEFAULT_PADDING, DEFAULT_POSITION, DEFAULT_VERTICAL_ALIGNMENT, visible
-
Constructor Summary
Constructors Constructor Description TextTitle()
Creates a new title, using default attributes where necessary.TextTitle(String text)
Creates a new title, using default attributes where necessary.TextTitle(String text, Font font)
Creates a new title, using default attributes where necessary.TextTitle(String text, Font font, Paint paint, RectangleEdge position, HorizontalAlignment horizontalAlignment, VerticalAlignment verticalAlignment, RectangleInsets padding)
Creates a new title. -
Method Summary
Modifier and Type Method Description Size2D
arrange(Graphics2D g2, RectangleConstraint constraint)
Arranges the contents of the block, within the given constraints, and returns the block size.protected Size2D
arrangeFN(Graphics2D g2, double w)
Arranges the content for this title assuming a fixed width and no bounds on the height, and returns the required size.protected Size2D
arrangeNN(Graphics2D g2)
Arranges the content for this title assuming no bounds on the width or the height, and returns the required size.protected Size2D
arrangeRN(Graphics2D g2, Range widthRange)
Arranges the content for this title assuming a range constraint for the width and no bounds on the height, and returns the required size.protected Size2D
arrangeRR(Graphics2D g2, Range widthRange, Range heightRange)
Returns the content size for the title.Object
clone()
Returns a clone of this object.void
draw(Graphics2D g2, Rectangle2D area)
Draws the title on a Java 2D graphics device (such as the screen or a printer).Object
draw(Graphics2D g2, Rectangle2D area, Object params)
Draws the block within the specified area.protected void
drawHorizontal(Graphics2D g2, Rectangle2D area)
Draws a the title horizontally within the specified area.protected void
drawVertical(Graphics2D g2, Rectangle2D area)
Draws a the title vertically within the specified area.boolean
equals(Object obj)
Tests this title for equality with another object.Paint
getBackgroundPaint()
Returns the background paint.boolean
getExpandToFitSpace()
Returns the flag that controls whether or not the title expands to fit the available space.Font
getFont()
Returns the font used to display the title string.int
getMaximumLinesToDisplay()
Returns the maximum number of lines to display.Paint
getPaint()
Returns the paint used to display the title string.String
getText()
Returns the title text.HorizontalAlignment
getTextAlignment()
Returns the text alignment.String
getToolTipText()
Returns the tool tip text.String
getURLText()
Returns the URL text.int
hashCode()
Returns a hash code.void
setBackgroundPaint(Paint paint)
Sets the background paint and sends aTitleChangeEvent
to all registered listeners.void
setExpandToFitSpace(boolean expand)
Sets the flag that controls whether the title expands to fit the available space, and sends aTitleChangeEvent
to all registered listeners.void
setFont(Font font)
Sets the font used to display the title string.void
setMaximumLinesToDisplay(int max)
Sets the maximum number of lines to display and sends aTitleChangeEvent
to all registered listeners.void
setPaint(Paint paint)
Sets the paint used to display the title string.void
setText(String text)
Sets the title to the specified text and sends aTitleChangeEvent
to all registered listeners.void
setTextAlignment(HorizontalAlignment alignment)
Sets the text alignment and sends aTitleChangeEvent
to all registered listeners.void
setToolTipText(String text)
Sets the tool tip text to the specified text and sends aTitleChangeEvent
to all registered listeners.void
setURLText(String text)
Sets the URL text to the specified text and sends aTitleChangeEvent
to all registered listeners.Methods inherited from class org.jfree.chart.title.Title
addChangeListener, getHorizontalAlignment, getNotify, getPosition, getVerticalAlignment, isVisible, notifyListeners, removeChangeListener, setHorizontalAlignment, setNotify, setPosition, setVerticalAlignment, setVisible
Methods inherited from class org.jfree.chart.block.AbstractBlock
arrange, calculateTotalHeight, calculateTotalWidth, drawBorder, getBounds, getContentXOffset, getContentYOffset, getFrame, getHeight, getID, getMargin, getPadding, getWidth, setBorder, setBounds, setFrame, setHeight, setID, setMargin, setMargin, setPadding, setPadding, setWidth, toContentConstraint, trimBorder, trimMargin, trimPadding, trimToContentHeight, trimToContentWidth
-
Field Details
-
DEFAULT_FONT
The default font. -
DEFAULT_TEXT_PAINT
The default text color.
-
-
Constructor Details
-
TextTitle
public TextTitle()Creates a new title, using default attributes where necessary. -
TextTitle
Creates a new title, using default attributes where necessary.- Parameters:
text
- the title text (null
not permitted).
-
TextTitle
Creates a new title, using default attributes where necessary.- Parameters:
text
- the title text (null
not permitted).font
- the title font (null
not permitted).
-
TextTitle
public TextTitle(String text, Font font, Paint paint, RectangleEdge position, HorizontalAlignment horizontalAlignment, VerticalAlignment verticalAlignment, RectangleInsets padding)Creates a new title.- Parameters:
text
- the text for the title (null
not permitted).font
- the title font (null
not permitted).paint
- the title paint (null
not permitted).position
- the title position (null
not permitted).horizontalAlignment
- the horizontal alignment (null
not permitted).verticalAlignment
- the vertical alignment (null
not permitted).padding
- the space to leave around the outside of the title.
-
-
Method Details
-
getText
Returns the title text.- Returns:
- The text (never
null
). - See Also:
setText(String)
-
setText
Sets the title to the specified text and sends aTitleChangeEvent
to all registered listeners.- Parameters:
text
- the text (null
not permitted).
-
getTextAlignment
Returns the text alignment. This controls how the text is aligned within the title's bounds, whereas the title's horizontal alignment controls how the title's bounding rectangle is aligned within the drawing space.- Returns:
- The text alignment.
-
setTextAlignment
Sets the text alignment and sends aTitleChangeEvent
to all registered listeners.- Parameters:
alignment
- the alignment (null
not permitted).
-
getFont
Returns the font used to display the title string.- Returns:
- The font (never
null
). - See Also:
setFont(Font)
-
setFont
Sets the font used to display the title string. Registered listeners are notified that the title has been modified.- Parameters:
font
- the new font (null
not permitted).- See Also:
getFont()
-
getPaint
Returns the paint used to display the title string.- Returns:
- The paint (never
null
). - See Also:
setPaint(Paint)
-
setPaint
Sets the paint used to display the title string. Registered listeners are notified that the title has been modified.- Parameters:
paint
- the new paint (null
not permitted).- See Also:
getPaint()
-
getBackgroundPaint
Returns the background paint.- Returns:
- The paint (possibly
null
).
-
setBackgroundPaint
Sets the background paint and sends aTitleChangeEvent
to all registered listeners. If you set this attribute tonull
, no background is painted (which makes the title background transparent).- Parameters:
paint
- the background paint (null
permitted).
-
getToolTipText
Returns the tool tip text.- Returns:
- The tool tip text (possibly
null
).
-
setToolTipText
Sets the tool tip text to the specified text and sends aTitleChangeEvent
to all registered listeners.- Parameters:
text
- the text (null
permitted).
-
getURLText
Returns the URL text.- Returns:
- The URL text (possibly
null
).
-
setURLText
Sets the URL text to the specified text and sends aTitleChangeEvent
to all registered listeners.- Parameters:
text
- the text (null
permitted).
-
getExpandToFitSpace
Returns the flag that controls whether or not the title expands to fit the available space.- Returns:
- The flag.
-
setExpandToFitSpace
Sets the flag that controls whether the title expands to fit the available space, and sends aTitleChangeEvent
to all registered listeners.- Parameters:
expand
- the flag.
-
getMaximumLinesToDisplay
Returns the maximum number of lines to display.- Returns:
- The maximum.
- See Also:
setMaximumLinesToDisplay(int)
-
setMaximumLinesToDisplay
Sets the maximum number of lines to display and sends aTitleChangeEvent
to all registered listeners.- Parameters:
max
- the maximum.- See Also:
getMaximumLinesToDisplay()
-
arrange
Arranges the contents of the block, within the given constraints, and returns the block size.- Specified by:
arrange
in interfaceBlock
- Overrides:
arrange
in classAbstractBlock
- Parameters:
g2
- the graphics device.constraint
- the constraint (null
not permitted).- Returns:
- The block size (in Java2D units, never
null
).
-
arrangeNN
Arranges the content for this title assuming no bounds on the width or the height, and returns the required size. This will reflect the fact that a text title positioned on the left or right of a chart will be rotated by 90 degrees.- Parameters:
g2
- the graphics target.- Returns:
- The content size.
-
arrangeFN
Arranges the content for this title assuming a fixed width and no bounds on the height, and returns the required size. This will reflect the fact that a text title positioned on the left or right of a chart will be rotated by 90 degrees.- Parameters:
g2
- the graphics target.w
- the width.- Returns:
- The content size.
-
arrangeRN
Arranges the content for this title assuming a range constraint for the width and no bounds on the height, and returns the required size. This will reflect the fact that a text title positioned on the left or right of a chart will be rotated by 90 degrees.- Parameters:
g2
- the graphics target.widthRange
- the range for the width.- Returns:
- The content size.
-
arrangeRR
Returns the content size for the title. This will reflect the fact that a text title positioned on the left or right of a chart will be rotated 90 degrees.- Parameters:
g2
- the graphics device.widthRange
- the width range.heightRange
- the height range.- Returns:
- The content size.
-
draw
Draws the title on a Java 2D graphics device (such as the screen or a printer). -
draw
Draws the block within the specified area.- Specified by:
draw
in interfaceBlock
- Parameters:
g2
- the graphics device.area
- the area.params
- if this is an instance ofEntityBlockParams
it is used to determine whether or not anEntityCollection
is returned by this method.- Returns:
- An
EntityCollection
containing a chart entity for the title, ornull
.
-
drawHorizontal
Draws a the title horizontally within the specified area. This method will be called from thedraw
method.- Parameters:
g2
- the graphics device.area
- the area for the title.
-
drawVertical
Draws a the title vertically within the specified area. This method will be called from thedraw
method.- Parameters:
g2
- the graphics device.area
- the area for the title.
-
equals
Tests this title for equality with another object. -
hashCode
Returns a hash code. -
clone
Returns a clone of this object.- Specified by:
clone
in interfacePublicCloneable
- Overrides:
clone
in classTitle
- Returns:
- A clone.
- Throws:
CloneNotSupportedException
- never.
-