ReportMill 10 API

com.reportmill.text
Class RMParagraph

java.lang.Object
  extended by com.reportmill.base.RMObject
      extended by com.reportmill.text.RMParagraph
All Implemented Interfaces:
java.lang.Cloneable

public class RMParagraph
extends com.reportmill.base.RMObject

This class represents attributes of a paragraph in an RMXString (all of the characters up to and including each newline in an RMXString make up a paragraph). Paragraphs can have their own alignment, indentation, min/max line height, etc. You might use this class like this:

   RMParagraph pgraph = RMParagraph.defaultParagraph.deriveAligned(RMParagraph.ALIGN_RIGHT);
   RMXString xstring = new RMXString("Hello World", pgraph);


Field Summary
static byte ALIGN_CENTER
           
static byte ALIGN_FULL
           
static byte ALIGN_LEFT
           
static byte ALIGN_RIGHT
           
static RMParagraph DEFAULT
           
static char TAB_CENTER
           
static char TAB_DECIMAL
           
static char TAB_LEFT
           
static char TAB_RIGHT
           
 
Constructor Summary
RMParagraph()
          Creates a new paragraph object initialized to defaultParagraph.
RMParagraph(int anAlign, float leftIndent, float leftIndentFirst, float rightIndent)
          Creates a new paragraph with the given alignment and indentation.
 
Method Summary
 RMParagraph deriveAligned(int anAlign)
          Returns a paragraph identical to the receiver, but with the given alignment.
 RMParagraph deriveIndent(float leftIndent, float leftIndentFirst, float rightIndent)
          Returns a paragraph identical to the receiver, but with the given indentation values.
 RMParagraph deriveLineGap(float aHeight)
          Returns a paragraph identical to the receiver, but with the given line gap.
 RMParagraph deriveLineHeightMax(float aHeight)
          Returns a paragraph identical to the receiver, but with the given max line height.
 RMParagraph deriveLineHeightMin(float aHeight)
          Returns a paragraph identical to the receiver, but with the given min line height.
 RMParagraph deriveLineSpacing(float aHeight)
          Returns a paragraph identical to the receiver, but with the given line spacing.
 RMParagraph deriveTab(int anIndex, float tabValue, char tabType)
          Returns a paragraph identical to the receiver, but with new value for tab at given index.
 RMParagraph deriveTabs(float[] newTabs, char[] newTypes)
          Returns a paragraph identical to the receiver, but with the given tabs.
 boolean equals(java.lang.Object anObj)
          Standard equals implementation.
 java.lang.Object fromXML(com.reportmill.archiver.RXArchiver anArchiver, com.reportmill.archiver.RXElement anElement)
          XML unarchival.
 byte getAlign()
          Returns the alignment associated with this paragraph.
 byte getAlign(java.lang.String aString)
          Returns an alignment for the given string, "left", "center", "right" or "full".
 java.lang.String getAlignString()
          Returns a string representation of the alignment associated with this paragraph, "left", "center" or "right".
 float getLeftIndent()
          Returns the left side indentation of this paragraph.
 float getLeftIndentFirst()
          Returns the left side indentation of the first line in this paragraph (this can be set different than successive lines).
 float getLineGap()
          Returns additional line spacing expressed as a constant amount in points.
 float getLineHeightMax()
          Returns the maximum line height in printer points associated with this paragraph.
 float getLineHeightMin()
          Returns the minimum line height in printer points associated with this paragraph.
 float getLineSpacing()
          Returns the spacing of lines expressed as a factor of a given line's height.
 float getParagraphSpacing()
          Returns the spacing between paragraphs in printer points associated with this paragraph.
 float getRightIndent()
          Returns the right side indentation of this paragraph.
 float getTab(int anIndex)
          Returns the specific tab value for the given index in printer points.
 int getTabCount()
          Returns the number of tabs associated with this paragraph.
 int getTabIndex(float aLocation)
          Returns the tab index for the given location.
 float[] getTabs()
          Returns the raw tab array
 java.lang.String getTabsString()
          Returns the values of all the tabs associated with this paragraph as a comma separated string.
 char getTabType(int anIndex)
          Returns the type of tab at the given index.
 char[] getTabTypes()
          Returns the raw tab type array
 void setTabs(float[] newTabs, char[] newTypes)
          Sets the tab stops.
 com.reportmill.archiver.RXElement toXML(com.reportmill.archiver.RXArchiver anArchiver)
          XML archival.
 
Methods inherited from class com.reportmill.base.RMObject
clone, copy, didChange, didUndo, getAnimAttribute, getClassNameShort, undoClone, undoCopy, undoEquals
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT

public static final RMParagraph DEFAULT

ALIGN_LEFT

public static final byte ALIGN_LEFT
See Also:
Constant Field Values

ALIGN_RIGHT

public static final byte ALIGN_RIGHT
See Also:
Constant Field Values

ALIGN_CENTER

public static final byte ALIGN_CENTER
See Also:
Constant Field Values

ALIGN_FULL

public static final byte ALIGN_FULL
See Also:
Constant Field Values

TAB_LEFT

public static final char TAB_LEFT
See Also:
Constant Field Values

TAB_RIGHT

public static final char TAB_RIGHT
See Also:
Constant Field Values

TAB_CENTER

public static final char TAB_CENTER
See Also:
Constant Field Values

TAB_DECIMAL

public static final char TAB_DECIMAL
See Also:
Constant Field Values
Constructor Detail

RMParagraph

public RMParagraph()
Creates a new paragraph object initialized to defaultParagraph. You should probably use RMParagraph.defaultParagraph instead.


RMParagraph

public RMParagraph(int anAlign,
                   float leftIndent,
                   float leftIndentFirst,
                   float rightIndent)
Creates a new paragraph with the given alignment and indentation.

Method Detail

getAlign

public byte getAlign()
Returns the alignment associated with this paragraph.


getAlignString

public java.lang.String getAlignString()
Returns a string representation of the alignment associated with this paragraph, "left", "center" or "right".


getAlign

public byte getAlign(java.lang.String aString)
Returns an alignment for the given string, "left", "center", "right" or "full".


getLeftIndent

public float getLeftIndent()
Returns the left side indentation of this paragraph.


getLeftIndentFirst

public float getLeftIndentFirst()
Returns the left side indentation of the first line in this paragraph (this can be set different than successive lines).


getRightIndent

public float getRightIndent()
Returns the right side indentation of this paragraph.


getLineSpacing

public float getLineSpacing()
Returns the spacing of lines expressed as a factor of a given line's height.


getLineGap

public float getLineGap()
Returns additional line spacing expressed as a constant amount in points.


getLineHeightMin

public float getLineHeightMin()
Returns the minimum line height in printer points associated with this paragraph.


getLineHeightMax

public float getLineHeightMax()
Returns the maximum line height in printer points associated with this paragraph.


getParagraphSpacing

public float getParagraphSpacing()
Returns the spacing between paragraphs in printer points associated with this paragraph.


getTabCount

public int getTabCount()
Returns the number of tabs associated with this paragraph.


getTab

public float getTab(int anIndex)
Returns the specific tab value for the given index in printer points.


getTabType

public char getTabType(int anIndex)
Returns the type of tab at the given index.


getTabs

public float[] getTabs()
Returns the raw tab array


getTabTypes

public char[] getTabTypes()
Returns the raw tab type array


getTabIndex

public int getTabIndex(float aLocation)
Returns the tab index for the given location.


getTabsString

public java.lang.String getTabsString()
Returns the values of all the tabs associated with this paragraph as a comma separated string.


deriveAligned

public RMParagraph deriveAligned(int anAlign)
Returns a paragraph identical to the receiver, but with the given alignment.


deriveIndent

public RMParagraph deriveIndent(float leftIndent,
                                float leftIndentFirst,
                                float rightIndent)
Returns a paragraph identical to the receiver, but with the given indentation values.


deriveLineSpacing

public RMParagraph deriveLineSpacing(float aHeight)
Returns a paragraph identical to the receiver, but with the given line spacing.


deriveLineGap

public RMParagraph deriveLineGap(float aHeight)
Returns a paragraph identical to the receiver, but with the given line gap.


deriveLineHeightMin

public RMParagraph deriveLineHeightMin(float aHeight)
Returns a paragraph identical to the receiver, but with the given min line height.


deriveLineHeightMax

public RMParagraph deriveLineHeightMax(float aHeight)
Returns a paragraph identical to the receiver, but with the given max line height.


setTabs

public void setTabs(float[] newTabs,
                    char[] newTypes)
Sets the tab stops.


deriveTabs

public RMParagraph deriveTabs(float[] newTabs,
                              char[] newTypes)
Returns a paragraph identical to the receiver, but with the given tabs.


deriveTab

public RMParagraph deriveTab(int anIndex,
                             float tabValue,
                             char tabType)
Returns a paragraph identical to the receiver, but with new value for tab at given index.


equals

public boolean equals(java.lang.Object anObj)
Standard equals implementation.

Overrides:
equals in class java.lang.Object

toXML

public com.reportmill.archiver.RXElement toXML(com.reportmill.archiver.RXArchiver anArchiver)
XML archival.


fromXML

public java.lang.Object fromXML(com.reportmill.archiver.RXArchiver anArchiver,
                                com.reportmill.archiver.RXElement anElement)
XML unarchival.


ReportMill 10 API