net.sf.paperclips
Class TextPrint

java.lang.Object
  extended by net.sf.paperclips.TextPrint
All Implemented Interfaces:
Print

public class TextPrint
extends java.lang.Object
implements Print

A Print for displaying text.

TextPrints are never greedy with layout space, even with center- or right-alignment. (Greedy prints take up all the available space on the page.) Therefore, when center- or right-alignment is required, it is necessary to wrap the text in a Print which will enforce the same alignment. Usually this is a center:default:grow or right:default:grow column in a GridPrint.


Field Summary
static int DEFAULT_ALIGN
          The default alignment for TextPrint.
static org.eclipse.swt.graphics.FontData DEFAULT_FONT_DATA
          The default font data for a TextPrint.
static java.lang.String DEFAULT_TEXT
          The default text for a TextPrint.
 
Constructor Summary
TextPrint()
          Constructs a TextPrint with the default properties.
TextPrint(java.lang.String text)
          Constructs a TextPrint with the given text.
TextPrint(java.lang.String text, org.eclipse.swt.graphics.FontData fontData)
          Constructs a TextPrint with the given text and font data.
TextPrint(java.lang.String text, org.eclipse.swt.graphics.FontData fontData, int align)
          Constructs a TextPrint with the given text, font data, and alignment.
TextPrint(java.lang.String text, int align)
          Constructs a TextPrint with the give text and alignment.
TextPrint(java.lang.String text, TextStyle style)
          Constructs a TextPrint with the given text and style.
 
Method Summary
 boolean equals(java.lang.Object obj)
           
 int getAlign()
          Deprecated. Use getAlignment() instead.
 int getAlignment()
          Returns the horizontal text alignment.
 org.eclipse.swt.graphics.RGB getBackground()
          Returns the background color.
 org.eclipse.swt.graphics.FontData getFontData()
          Returns the font that will be used to print the text.
 org.eclipse.swt.graphics.RGB getForeground()
          Returns the foreground color.
 org.eclipse.swt.graphics.RGB getRGB()
          Deprecated. Use getForeground() instead.
 boolean getStrikeout()
          Returns the strikout flag.
 TextStyle getStyle()
          Returns the text style.
 java.lang.String getText()
          Returns the text that will be printed.
 boolean getUnderline()
          Returns the underline flag.
 boolean getWordSplitting()
          Returns whether word splitting is enabled.
 int hashCode()
           
 PrintIterator iterator(org.eclipse.swt.graphics.Device device, org.eclipse.swt.graphics.GC gc)
          Returns a PrintIterator for laying out the contents of this Print.
 void setAlign(int alignment)
          Deprecated. Use setAlignment(int) instead.
 void setAlignment(int alignment)
          Sets the horizontal text alignment.
 void setBackground(org.eclipse.swt.graphics.RGB background)
          Sets the background color to the argument.
 void setFontData(org.eclipse.swt.graphics.FontData fontData)
          Sets the font that will be used to print the text.
 void setForeground(org.eclipse.swt.graphics.RGB foreground)
          Sets the foreground color to the argument.
 void setRGB(org.eclipse.swt.graphics.RGB foreground)
          Deprecated. Use setForeground(RGB) instead.
 void setStrikeout(boolean strikeout)
          Sets the strikeout flag to the argument.
 void setStyle(TextStyle style)
          Sets the text style to the argument.
 void setText(java.lang.String text)
          Sets the text that will be printed.
 void setUnderline(boolean underline)
          Sets the underline flag to the argument.
 void setWordSplitting(boolean wordBreaking)
          Sets whether word splitting is enabled.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_TEXT

public static final java.lang.String DEFAULT_TEXT
The default text for a TextPrint. Value is "".

See Also:
Constant Field Values

DEFAULT_FONT_DATA

public static final org.eclipse.swt.graphics.FontData DEFAULT_FONT_DATA
The default font data for a TextPrint. Value is device-dependent.


DEFAULT_ALIGN

public static final int DEFAULT_ALIGN
The default alignment for TextPrint. Value is SWT.LEFT.

See Also:
Constant Field Values
Constructor Detail

TextPrint

public TextPrint()
Constructs a TextPrint with the default properties.


TextPrint

public TextPrint(java.lang.String text)
Constructs a TextPrint with the given text.

Parameters:
text - the text to print.

TextPrint

public TextPrint(java.lang.String text,
                 org.eclipse.swt.graphics.FontData fontData)
Constructs a TextPrint with the given text and font data.

Parameters:
text - the text to print.
fontData - the font that will be used to print the text.

TextPrint

public TextPrint(java.lang.String text,
                 int align)
Constructs a TextPrint with the give text and alignment.

Parameters:
text - the text to print.
align - the horizontal text alignment. Must be one of SWT.LEFT , SWT.CENTER or SWT.RIGHT.

TextPrint

public TextPrint(java.lang.String text,
                 org.eclipse.swt.graphics.FontData fontData,
                 int align)
Constructs a TextPrint with the given text, font data, and alignment.

Parameters:
text - the text to print.
fontData - the font that will be used to print the text.
align - the horizontal text alignment. Must be one of SWT.LEFT , SWT.CENTER or SWT.RIGHT.

TextPrint

public TextPrint(java.lang.String text,
                 TextStyle style)
Constructs a TextPrint with the given text and style.

Parameters:
text - the text to print.
style - the style to apply to the text.
Method Detail

hashCode

public int hashCode()
Overrides:
hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)
Overrides:
equals in class java.lang.Object

getText

public java.lang.String getText()
Returns the text that will be printed.

Returns:
the text that will be printed.

setText

public void setText(java.lang.String text)
Sets the text that will be printed.

Parameters:
text - the text to print.

getStyle

public TextStyle getStyle()
Returns the text style.

Returns:
the text style.

setStyle

public void setStyle(TextStyle style)
Sets the text style to the argument.

Parameters:
style - the new text style.

getFontData

public org.eclipse.swt.graphics.FontData getFontData()
Returns the font that will be used to print the text.

Returns:
the font that will be used to print the text.

setFontData

public void setFontData(org.eclipse.swt.graphics.FontData fontData)
Sets the font that will be used to print the text.

Parameters:
fontData - the font that will be used to print the text.

getAlign

public int getAlign()
Deprecated. Use getAlignment() instead.

Returns the horizontal text alignment. Possible values include SWT.LEFT, SWT.CENTER or SWT.RIGHT.

Returns:
the horizontal text alignment.

setAlign

public void setAlign(int alignment)
Deprecated. Use setAlignment(int) instead.

Sets the horizontal text alignment.

Parameters:
alignment - the horizontal text alignment. Must be one of SWT.LEFT , SWT.CENTER or SWT.RIGHT.

getAlignment

public int getAlignment()
Returns the horizontal text alignment. Possible values include SWT.LEFT, SWT.CENTER or SWT.RIGHT.

Returns:
the horizontal text alignment.

setAlignment

public void setAlignment(int alignment)
Sets the horizontal text alignment.

Parameters:
alignment - the horizontal text alignment. Must be one of SWT.LEFT , SWT.CENTER or SWT.RIGHT.

getRGB

public org.eclipse.swt.graphics.RGB getRGB()
Deprecated. Use getForeground() instead.

Returns the foreground color.

Returns:
the foreground color.

setRGB

public void setRGB(org.eclipse.swt.graphics.RGB foreground)
Deprecated. Use setForeground(RGB) instead.

Sets the foreground color to the argument.

Parameters:
foreground - the new foreground color.

getForeground

public org.eclipse.swt.graphics.RGB getForeground()
Returns the foreground color. A null value indicates that the foreground color is inherited.

Returns:
the foreground color.

setForeground

public void setForeground(org.eclipse.swt.graphics.RGB foreground)
Sets the foreground color to the argument.

Parameters:
foreground - the new foreground color. A null value causes the foreground color to be inherited.

getBackground

public org.eclipse.swt.graphics.RGB getBackground()
Returns the background color. A null value indicates that the background is transparent.

Returns:
the background color.

setBackground

public void setBackground(org.eclipse.swt.graphics.RGB background)
Sets the background color to the argument.

Parameters:
background - the new background color. A null value causes the background to be transparent.

getUnderline

public boolean getUnderline()
Returns the underline flag.

Returns:
the underline flag.

setUnderline

public void setUnderline(boolean underline)
Sets the underline flag to the argument.

Parameters:
underline - the underline flag.

getStrikeout

public boolean getStrikeout()
Returns the strikout flag.

Returns:
the strikout flag.

setStrikeout

public void setStrikeout(boolean strikeout)
Sets the strikeout flag to the argument.

Parameters:
strikeout - the strikeout flag.

getWordSplitting

public boolean getWordSplitting()
Returns whether word splitting is enabled. Default is true.

Returns:
whether word splitting is enabled.

setWordSplitting

public void setWordSplitting(boolean wordBreaking)
Sets whether word splitting is enabled.

Parameters:
wordBreaking - whether to allow word splitting.

iterator

public PrintIterator iterator(org.eclipse.swt.graphics.Device device,
                              org.eclipse.swt.graphics.GC gc)
Description copied from interface: Print
Returns a PrintIterator for laying out the contents of this Print. The iterator uses a snapshot of the print at the time this method is invoked, so subsequent changes to the Print will not affect the output of the iterator.

Specified by:
iterator in interface Print
Parameters:
device - the graphics device this Print will be drawn onto.
gc - the graphics context to be used for calculating layout and drawing the Print's contents.
Returns:
a PrintIterator for laying out the contents of this Print.