Package com.inet.report
Class Paragraph
- java.lang.Object
-
- com.inet.report.ReportComponent
-
- com.inet.report.Element
-
- com.inet.report.Paragraph
-
- All Implemented Interfaces:
GeneralProperties,ParagraphProperties,NodeParser,com.inet.report.ReferenceHolder,java.io.Serializable,java.lang.Cloneable
public class Paragraph extends Element implements ParagraphProperties
TheParagraphclass represents a line in aTextand is a set ofTextPartelements andFieldPartelements. I.e. aParagraphthat consists of a text formatted with blue color, a field, a text formatted with red color and a text formatted with blue color, has to be split into four parts; threeTextPartelements and oneFieldPartelement. The last part of aParagraphis terminated with a newline. After aFieldPartelement, aTextPartelement that contains a newline is required.
This class is part of the RDC.- See Also:
Text,TextPart,FieldPart, Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.inet.report.Element
Element.BorderProps, Element.CommonProperties, Element.ElementTypes, Element.HyperlinkProps, Element.StringProps
-
-
Field Summary
-
Fields inherited from class com.inet.report.Element
BOX, CHART, CROSSTAB, CROSSTABSECTION, DATABASE_PICTURE, FIELD, FIELDPART, FORMFIELD, INTERACTIVE_SORTING, JAVABEAN, LINE, PARAGRAPH, PICTURE, SIGNATURE, SUBREPORT, TEXT, TEXTPART
-
Fields inherited from interface com.inet.report.GeneralProperties
ALIGN_HORIZONTAL_CENTER, ALIGN_HORIZONTAL_DEFAULT, ALIGN_HORIZONTAL_JUSTIFIED, ALIGN_HORIZONTAL_LEFT, ALIGN_HORIZONTAL_RIGHT
-
Fields inherited from interface com.inet.report.ParagraphProperties
INDENT_DEFAULT, LINE_SPACING_ABSOLUTE, LINE_SPACING_RELATIVE
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description FieldPartaddFieldPart(Field newField)Creates a new field part element and adds it into this paragraph.TextPartaddTextPart(java.lang.String newText)Creates a new text part element and adds it into this paragraph.intgetFirstLineIndent()Returns the value of the property 'first line indent'.FormulaFieldgetFirstLineIndentFormula()Returns the formula whose return value determines the property 'first line indent'.intgetLeftIndent()Returns the value of the property 'left indent'.FormulaFieldgetLeftIndentFormula()Returns the formula whose return value determines the property 'left indent'.intgetLineSpacingAbsolute()Returns the absolute distance between baselines of the lines in this paragraph, measured in twips.FormulaFieldgetLineSpacingAbsoluteFormula()Returns the formula whose return value determines the absolute distance between baselines of the lines in this paragraph, measured in twips.doublegetLineSpacingRelative()Returns the factor by which the default line spacing is to be multiplied for this paragraph.FormulaFieldgetLineSpacingRelativeFormula()Returns the formula whose return value determines the factor by which the default line spacing is to be multiplied for this paragraph.ElementgetPart(int idx)Returns the TextPart or the FieldPart at the specified index.intgetPartCount()Returns the number of TextParts and FieldParts of this paragraph.intgetRightIndent()Returns the value of the property 'rightIndent'.FormulaFieldgetRightIndentFormula()Returns the formula whose return value determines the property 'right indent'.java.util.List<? extends ReportComponent>getSubComponents()Returns allReportComponents that are descendants of this one.TextgetText()Returns the parentTextelement.intindexOf()Returns the index of this Paragraph inside the parent Text element.FieldPartinsertFieldPart(int pos, Field newfield)Inserts a FieldPart element into this Paragraph.TextPartinsertTextPart(int pos, java.lang.String newtext)Inserts a text element into this Paragraph.voidmoveParts(int srcPos, Paragraph dest, int destPos, int length)Move FieldParts and TextParts from this Paragraph, beginning at the specified position, to the specified position of the destination Paragraph.voidnormalize(boolean replacePrompts)Normalizes this paragraph.java.lang.StringparamString()Creates and return a String representation for debugging.NodeParserparseElement(com.inet.report.parser.XMLTag group, java.lang.String tag, org.xml.sax.Attributes atts, java.util.Map<java.lang.String,java.lang.Object> parserMap)FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XMLvoidparseText(java.lang.String text, java.util.Map<java.lang.String,java.lang.Object> parserMap)FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XMLvoidremovePart(int idx)Removes the TextPart or the FieldPart at the specified index.voidresetReferences()FOR INTERNAL USE ONLYvoidsetFirstLineIndent(int newValue)Sets the value of the property 'first line indent'.voidsetFirstLineIndentFormula(FormulaField formula)Sets the formula whose return value determines the property 'first line indent'.voidsetLeftIndent(int newLeftIndent)Sets the value of the property 'left indent'.voidsetLeftIndentFormula(FormulaField formula)Sets the formula whose return value determines the property 'left indent'.voidsetLineSpacingAbsolute(int lineSpacingAbsolute)Sets the absolute distance between baselines of the lines in this paragraph, measured in twips.voidsetLineSpacingAbsoluteFormula(FormulaField formula)Sets the formula whose return value determines the absolute distance between baselines of the lines in this paragraph, measured in twips.voidsetLineSpacingRelative(double lineSpacingRelative)Sets the factor by which the default line spacing is to be multiplied for this paragraph.voidsetLineSpacingRelativeFormula(FormulaField formula)Sets the formula whose return value determines the factor by which the default line spacing is to be multiplied for this paragraph.voidsetReferences()FOR INTERNAL USE ONLYvoidsetRightIndent(int newRightIndent)Sets the value of the property 'rightIndent'.voidsetRightIndentFormula(FormulaField formula)Sets the formula whose return value determines the property 'right indent'.-
Methods inherited from class com.inet.report.Element
addListener, copy, getBottomLineStyle, getBottomLineStyleFormula, getBulletValueStack, getCanGrowCount, getCanGrowFormula, getCloseBorderOnPageBreakFormula, getDropShadowFormula, getEngine, getField, getForeColor, getForeColorFormula, getHorAlign, getHorAlignFormula, getHyperlinkUrl, getHyperlinkUrlFormula, getLeftLineStyle, getLeftLineStyleFormula, getListStack, getParent, getPropertyFormulas, getRightLineStyle, getRightLineStyleFormula, getSuppressIfDuplicatedFormula, getTightHorizontalFormula, getToolTipsText, getToolTipsTextFormula, getTopLineStyle, getTopLineStyleFormula, getTypeAsString, isCanGrow, isCloseBorderOnPageBreak, isCloseBorderOnPageBreakInternal, isDropShadow, isInCrossTab, isSuppressIfDuplicated, isTightHorizontal, removeListener, setBottomLineStyle, setBottomLineStyleFormula, setBulletValueStack, setCanGrow, setCanGrowCount, setCanGrowFormula, setCloseBorderOnPageBreak, setCloseBorderOnPageBreakFormula, setDropShadow, setDropShadowFormula, setField, setForeColor, setForeColorFormula, setHorAlign, setHorAlignFormula, setHyperlinkUrl, setHyperlinkUrlFormula, setIndex, setLeftLineStyle, setLeftLineStyleFormula, setListStack, setRightLineStyle, setRightLineStyleFormula, setSuppressIfDuplicated, setSuppressIfDuplicatedFormula, setTightHorizontal, setTightHorizontalFormula, setToolTipsText, setToolTipsTextFormula, setTopLineStyle, setTopLineStyleFormula
-
Methods inherited from class com.inet.report.ReportComponent
addPropertyChangeListener, addPropertyChangeListener, addReferencedObject, addVetoableChangeListener, addVetoableChangeListener, getBackColor, getBackColorFormula, getCustomData, getHeight, getKeepTogetherFormula, getRealReferencedObjectCount, getReferencedObjectCount, getReferencedObjects, getSuppressFormula, getType, getWidth, getX, getY, isDOMParser, isKeepTogether, isSuppress, parseDOM, parseEndElement, removePropertyChangeListener, removePropertyChangeListener, removeReferencedObject, removeVetoableChangeListener, removeVetoableChangeListener, setBackColor, setBackColorFormula, setCustomData, setHeight, setKeepTogether, setKeepTogetherFormula, setSuppress, setSuppressFormula, setWidth, setX, setY
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.inet.report.GeneralProperties
getKeepTogetherFormula, getSuppressFormula, isKeepTogether, isSuppress, setKeepTogether, setKeepTogetherFormula, setSuppress, setSuppressFormula
-
-
-
-
Method Detail
-
getText
public Text getText()
Returns the parentTextelement.- Returns:
- The parent of this Paragraph.
- Since:
- 6.0
-
addTextPart
public TextPart addTextPart(java.lang.String newText)
Creates a new text part element and adds it into this paragraph. If parametertextisnull, it will be replaced by an empty String.- Parameters:
newText- the text of the text part as String- Returns:
- the created text part element
- Since:
- 6.0
-
insertTextPart
public TextPart insertTextPart(int pos, java.lang.String newtext)
Inserts a text element into this Paragraph. The new text element will be placed at the desired position. Invalid positions will be adjusted to the nearest boundary of this Paragraph.- Parameters:
pos- The position where the text element shall be stored.newtext- The new text element that shall be stored.- Returns:
- the inserted TextPart
- Since:
- 7.0
-
addFieldPart
public FieldPart addFieldPart(Field newField)
Creates a new field part element and adds it into this paragraph.- Parameters:
newField- The field which should be added into the paragraph.- Returns:
- the created field part element.
- Since:
- 6.0
- See Also:
DatabaseField,FormulaField,PromptField,GroupField,SummaryField,SQLField
-
insertFieldPart
public FieldPart insertFieldPart(int pos, Field newfield)
Inserts a FieldPart element into this Paragraph. The new field will be placed at the desired position. Invalid positions will be adjusted to the nearest boundary of this Paragraph.- Parameters:
pos- The position where the element shall be stored.newfield- The new field that shall be stored.- Returns:
- the inserted FieldPart
- Since:
- 7.0
-
getPart
public Element getPart(int idx)
Returns the TextPart or the FieldPart at the specified index.- Parameters:
idx- The index of the FieldPart or of the TextPart that should returned.- Returns:
- the part at the given index
- Since:
- 6.0
- See Also:
TextPart,FieldPart,addFieldPart(Field),addTextPart(String),getPartCount(),removePart(int)
-
getPartCount
public int getPartCount()
Returns the number of TextParts and FieldParts of this paragraph.- Returns:
- the number of child parts
- Since:
- 6.0
- See Also:
TextPart,FieldPart,addFieldPart(Field),addTextPart(String),getPart(int),removePart(int)
-
removePart
public void removePart(int idx)
Removes the TextPart or the FieldPart at the specified index.- Parameters:
idx- The index of the FieldPart or of the TextPart that should removed.- Throws:
java.lang.IndexOutOfBoundsException- ifidxis out of bounds.- Since:
- 6.0
- See Also:
TextPart,FieldPart,addFieldPart(Field),addTextPart(String),getPart(int),getPartCount()
-
moveParts
public void moveParts(int srcPos, Paragraph dest, int destPos, int length) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentExceptionMove FieldParts and TextParts from this Paragraph, beginning at the specified position, to the specified position of the destination Paragraph. Both Paragraph must come from the same Engine. It work also with the same Paragraph if the destPos is outside of the source range.- Parameters:
srcPos- starting position in this Paragraph. This is the index of FieldPart and TextPart starting with 0.dest- the destination ParagraphdestPos- starting position in the destination Paragraph. This is the index of FieldPart and TextPart starting with 0.length- count of parts that should be moved.- Throws:
java.lang.IndexOutOfBoundsException- if srcPos, destPost or length is out of bounds.java.lang.IllegalArgumentException- If the Paragraph come from different Engines- Since:
- 9.1
-
paramString
public java.lang.String paramString()
Creates and return a String representation for debugging.- Overrides:
paramStringin classElement- Returns:
- String representation of this Element for debugging purposes
-
indexOf
public int indexOf()
Returns the index of this Paragraph inside the parent Text element.- Overrides:
indexOfin classElement- Returns:
- the index position in the Text element
- Since:
- 6.0
- See Also:
Element.setIndex(int)
-
setReferences
public void setReferences()
FOR INTERNAL USE ONLY- Specified by:
setReferencesin interfacecom.inet.report.ReferenceHolder- Overrides:
setReferencesin classElement- Since:
- 6.0
-
resetReferences
public void resetReferences()
FOR INTERNAL USE ONLY- Specified by:
resetReferencesin interfacecom.inet.report.ReferenceHolder- Overrides:
resetReferencesin classReportComponent
-
getFirstLineIndent
public int getFirstLineIndent()
Returns the value of the property 'first line indent'. This is the distance that the first line of the paragraph is indented from the left margin of the paragraph (in twips).- Specified by:
getFirstLineIndentin interfaceParagraphProperties- Returns:
- The value of the property 'first line indent'.
-
setFirstLineIndent
public void setFirstLineIndent(int newValue)
Sets the value of the property 'first line indent'. This is the distance that the first line of the paragraph is indented from the left margin of the paragraph (in twips).- Specified by:
setFirstLineIndentin interfaceParagraphProperties- Parameters:
newValue- The new value of the property 'first line indent'. May be negative (which would cause the first line to be left of the left margin).
-
getLeftIndent
public int getLeftIndent()
Returns the value of the property 'left indent'. This is the distance that the the paragraph is indented from the left margin of the element (in twips).- Specified by:
getLeftIndentin interfaceParagraphProperties- Returns:
- The value of the property 'left indent'.
-
setLeftIndent
public void setLeftIndent(int newLeftIndent)
Sets the value of the property 'left indent'. This is the distance that the the paragraph is indented from the left margin of the element (in twips).- Specified by:
setLeftIndentin interfaceParagraphProperties- Parameters:
newLeftIndent- The new value of the property 'left indent'.
-
getRightIndent
public int getRightIndent()
Returns the value of the property 'rightIndent'. This is the distance that the the paragraph is indented from the right margin of the element (in twips).- Specified by:
getRightIndentin interfaceParagraphProperties- Returns:
- The current value of the property 'rightIndent'.
-
setRightIndent
public void setRightIndent(int newRightIndent)
Sets the value of the property 'rightIndent'. This is the distance that the the paragraph is indented from the right margin of the element (in twips).- Specified by:
setRightIndentin interfaceParagraphProperties- Parameters:
newRightIndent- The new value of the property 'rightIndent'.
-
setLineSpacingAbsolute
public void setLineSpacingAbsolute(int lineSpacingAbsolute)
Sets the absolute distance between baselines of the lines in this paragraph, measured in twips. It is also possible to set LINE_SPACING_RELATIVE, which restores the default setting.- Specified by:
setLineSpacingAbsolutein interfaceParagraphProperties- Parameters:
lineSpacingAbsolute- Absolute distance between baselines in this paragraph, measured in twips, or LINE_SPACING_RELATIVE in order to restore the default setting.- See Also:
ParagraphProperties.getLineSpacingAbsolute(),ParagraphProperties.LINE_SPACING_RELATIVE
-
getLineSpacingAbsolute
public int getLineSpacingAbsolute()
Returns the absolute distance between baselines of the lines in this paragraph, measured in twips. If a relative factor has been set, this will return the constant LINE_SPACING_RELATIVE.- Specified by:
getLineSpacingAbsolutein interfaceParagraphProperties- Returns:
- Absolute distance between baselines in this paragraph, measured in twips, or LINE_SPACING_RELATIVE
- See Also:
ParagraphProperties.setLineSpacingAbsolute(int),ParagraphProperties.LINE_SPACING_RELATIVE
-
setLineSpacingRelative
public void setLineSpacingRelative(double lineSpacingRelative)
Sets the factor by which the default line spacing is to be multiplied for this paragraph. The default line spacing is determined by font and font size, and is then multiplied by this number. Setting LINE_SPACING_ABSOLUTE will cause the value to be reset to its default, which is "1".- Specified by:
setLineSpacingRelativein interfaceParagraphProperties- Parameters:
lineSpacingRelative- Factor by which the default line spacing is to be multiplied for this paragraph, or LINE_SPACING_ABSOLUTE if the default value is to be set (equivalent to "1")- See Also:
ParagraphProperties.LINE_SPACING_ABSOLUTE,ParagraphProperties.getLineSpacingRelative()
-
getLineSpacingRelative
public double getLineSpacingRelative()
Returns the factor by which the default line spacing is to be multiplied for this paragraph. The default line spacing is determined by font and font size, and is then multiplied by this number. If an absolute value has been set, this will return LINE_SPACING_ABSOLUTE instead.- Specified by:
getLineSpacingRelativein interfaceParagraphProperties- Returns:
- Factor by which the default line spacing is to be multiplied for this paragraph, or LINE_SPACING_ABSOLUTE if an absolute line spacing distance has been set.
- See Also:
ParagraphProperties.LINE_SPACING_ABSOLUTE,ParagraphProperties.getLineSpacingRelative()
-
normalize
public void normalize(boolean replacePrompts)
Normalizes this paragraph. This means that empty TextParts will be removed and TextParts with the same font properties will be merged. Currently the following properties will be compared to check if the TextParts can be merged.
- font color and formula
- fonr name and formula
- font size and formula
- font style and formula
- strikeout and formula
- underline and formula
- Parameters:
replacePrompts- replace prompt fields with it current value- Since:
- 9.1
-
getFirstLineIndentFormula
public FormulaField getFirstLineIndentFormula()
Returns the formula whose return value determines the property 'first line indent'. This is the distance that the first line of the paragraph is indented from the left margin of the paragraph (in twips).- Specified by:
getFirstLineIndentFormulain interfaceParagraphProperties- Returns:
- The formula whose return value determines the property 'first line indent'.
-
getLeftIndentFormula
public FormulaField getLeftIndentFormula()
Returns the formula whose return value determines the property 'left indent'. This is the distance that the the paragraph is indented from the left margin of the element (in twips).- Specified by:
getLeftIndentFormulain interfaceParagraphProperties- Returns:
- The formula whose return value determines the property 'left indent'.
-
getLineSpacingAbsoluteFormula
public FormulaField getLineSpacingAbsoluteFormula()
Returns the formula whose return value determines the absolute distance between baselines of the lines in this paragraph, measured in twips.- Specified by:
getLineSpacingAbsoluteFormulain interfaceParagraphProperties- Returns:
- Absolute distance between baselines in this paragraph, measured in twips
- See Also:
ParagraphProperties.setLineSpacingAbsolute(int)
-
getLineSpacingRelativeFormula
public FormulaField getLineSpacingRelativeFormula()
Returns the formula whose return value determines the factor by which the default line spacing is to be multiplied for this paragraph. The default line spacing is determined by font and font size, and is then multiplied by this formula's value.- Specified by:
getLineSpacingRelativeFormulain interfaceParagraphProperties- Returns:
- formula whose return value determines the factor by which the default line spacing is to be multiplied for this paragraph
- See Also:
ParagraphProperties.getLineSpacingRelative()
-
getRightIndentFormula
public FormulaField getRightIndentFormula()
Returns the formula whose return value determines the property 'right indent'. This is the distance that the the paragraph is indented from the right margin of the element (in twips).- Specified by:
getRightIndentFormulain interfaceParagraphProperties- Returns:
- The formula whose return value determines the property 'right indent'.
-
setFirstLineIndentFormula
public void setFirstLineIndentFormula(FormulaField formula)
Sets the formula whose return value determines the property 'first line indent'. This is the distance that the first line of the paragraph is indented from the left margin of the paragraph (in twips).- Specified by:
setFirstLineIndentFormulain interfaceParagraphProperties- Parameters:
formula- The formula whose return value determines the property 'first line indent'.
-
setLeftIndentFormula
public void setLeftIndentFormula(FormulaField formula)
Sets the formula whose return value determines the property 'left indent'. This is the distance that the the paragraph is indented from the left margin of the element (in twips).- Specified by:
setLeftIndentFormulain interfaceParagraphProperties- Parameters:
formula- The formula whose return value determines the property 'left indent'.
-
setLineSpacingAbsoluteFormula
public void setLineSpacingAbsoluteFormula(FormulaField formula)
Sets the formula whose return value determines the absolute distance between baselines of the lines in this paragraph, measured in twips.- Specified by:
setLineSpacingAbsoluteFormulain interfaceParagraphProperties- Parameters:
formula- formula whose return value determines the absolute distance between baselines in this paragraph, measured in twips- See Also:
ParagraphProperties.setLineSpacingAbsolute(int)
-
setLineSpacingRelativeFormula
public void setLineSpacingRelativeFormula(FormulaField formula)
Sets the formula whose return value determines the factor by which the default line spacing is to be multiplied for this paragraph. The default line spacing is determined by font and font size, and is then multiplied by this formula's value.- Specified by:
setLineSpacingRelativeFormulain interfaceParagraphProperties- Parameters:
formula- formula whose return value determines the factor by which the default line spacing is to be multiplied for this paragraph- See Also:
ParagraphProperties.setLineSpacingRelative(double)
-
setRightIndentFormula
public void setRightIndentFormula(FormulaField formula)
Sets the formula whose return value determines the property 'right indent'. This is the distance that the the paragraph is indented from the right margin of the element (in twips).- Specified by:
setRightIndentFormulain interfaceParagraphProperties- Parameters:
formula- The formula whose return value determines the property 'right indent'.
-
parseElement
public NodeParser parseElement(com.inet.report.parser.XMLTag group, java.lang.String tag, org.xml.sax.Attributes atts, java.util.Map<java.lang.String,java.lang.Object> parserMap) throws FatalParserException
FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XMLParses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself. Note that the parsing is highly tolerant, i.e. exceptions are intercepted and suppressed if at all possible.
- Specified by:
parseElementin interfaceNodeParser- Overrides:
parseElementin classElement- Parameters:
group- XMLTag of the current node to be parsed, or null if there is no such current group. An XMLTag is a group of nodes bundled together, usually it is a Properties node such as CommonProperties, BorderProperties, etc.tag- The XMLTag to be parsedatts- The set of attributes in the current XMLTagparserMap- The map of current Parser.- Returns:
- The NodeParser sub-element if one needed to be created, or null if none was created.
- Throws:
FatalParserException- if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.
-
parseText
public void parseText(java.lang.String text, java.util.Map<java.lang.String,java.lang.Object> parserMap)FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XMLThis method is called if text was encountered in the context of this node. (Examples would be a formula's text or a text element's text)
- Specified by:
parseTextin interfaceNodeParser- Overrides:
parseTextin classElement- Parameters:
text- text encountered and to be storedparserMap- The map of current Parser.
-
getSubComponents
public java.util.List<? extends ReportComponent> getSubComponents()
Returns allReportComponents that are descendants of this one. E.G. this will return all Element of aSection. But it's as well useful forCrossTabs orTextelements which have additional elements.- Specified by:
getSubComponentsin classReportComponent- Returns:
- a list with all sub components which can be empty as well; will be
nullif the component has no descendants
-
-