Package com.inet.report
Class Box
- java.lang.Object
-
- All Implemented Interfaces:
BorderProperties
,BoxProperties
,GeneralProperties
,HyperlinkProperties
,LineProperties
,NodeParser
,com.inet.report.ReferenceHolder
,java.io.Serializable
,java.lang.Cloneable
public class Box extends AbstractLineElement implements BoxProperties, HyperlinkProperties
This class represents a box in the report. You can use boxes to enclose other visible elements in the report or to create some graphics. A box can inserted in a single section (useSection.addBox(int, int, int, int)
method in classSection
) and can span some sections (use methodSection.addBox(int, int, int, int, int, Section)
in classSection
). In second case the last argument of theSection.addBox(int, int, int, int, int, Section)
method is the section in that the box will end.
A box differs from borders of an object in the report. Boxes have freeform size and position, where borders has fixed size and are positioned around the bordered object. The border of a field will drawed around each coming value, where a box enclose all. A border cann't be enclose nothing, a box can placed everywhere in the report and don't need to enclose something. No border can span some sections.
If you want to change the color of the box, use methodsElement.setForeColor(int)
to change the color of the border and methodReportComponent.setBackColor(int)
to change the background color of the box inheritated fromElement
.
This class is part of the RDC.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Box.BoxProps
FOR INTERNAL USE ONLY-
Nested classes/interfaces inherited from class com.inet.report.AbstractLineElement
AbstractLineElement.LineProperties
-
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.BorderProperties
LINE_STYLE_DASHED, LINE_STYLE_DOTTED, LINE_STYLE_DOUBLE, LINE_STYLE_SINGLE, NO_LINE
-
Fields inherited from interface com.inet.report.GeneralProperties
ALIGN_HORIZONTAL_CENTER, ALIGN_HORIZONTAL_DEFAULT, ALIGN_HORIZONTAL_JUSTIFIED, ALIGN_HORIZONTAL_LEFT, ALIGN_HORIZONTAL_RIGHT
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
getCornerEllipseHeight()
Returns the value of the property 'corner ellipse height'.int
getCornerEllipseWidth()
Returns the value of the property 'corner ellipse width'.java.util.List<? extends ReportComponent>
getSubComponents()
Returns allReportComponent
s that are descendants of this one.boolean
isCloseBorderOnPageBreak()
Returns the value of the property 'close border on page break'.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)
FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XMLvoid
setCloseBorderOnPageBreak(boolean newValue)
Sets the value of the property 'close border on page break'.void
setCornerEllipseHeight(int newValue)
Sets the value of the property 'corner ellipse height'.void
setCornerEllipseWidth(int newValue)
Sets the value of the property 'corner ellipse width'.-
Methods inherited from class com.inet.report.AbstractLineElement
getBottomLineStyle, getEndSection, getHeight, getLeftLineStyle, getLineStyle, getLineWidth, getRightLineStyle, getTopLineStyle, getWidth, getX2, getY2, isExtendToBottomOfSectionWhenPrinting, isMultiSectionElement, parseText, setEndSection, setExtendToBottomOfSectionWhenPrinting, setHeight, setLineStyle, setLineWidth, setWidth, setX2, setY2, spansMultipleSections
-
Methods inherited from class com.inet.report.Element
addListener, copy, getBottomLineStyleFormula, getBulletValueStack, getCanGrowCount, getCanGrowFormula, getCloseBorderOnPageBreakFormula, getDropShadowFormula, getEngine, getField, getForeColor, getForeColorFormula, getHorAlign, getHorAlignFormula, getHyperlinkUrl, getHyperlinkUrlFormula, getLeftLineStyleFormula, getListStack, getParent, getPropertyFormulas, getRightLineStyleFormula, getSuppressIfDuplicatedFormula, getTightHorizontalFormula, getToolTipsText, getToolTipsTextFormula, getTopLineStyleFormula, getTypeAsString, indexOf, isCanGrow, isCloseBorderOnPageBreakInternal, isDropShadow, isInCrossTab, isSuppressIfDuplicated, isTightHorizontal, paramString, removeListener, setBottomLineStyle, setBottomLineStyleFormula, setBulletValueStack, setCanGrow, setCanGrowCount, setCanGrowFormula, setCloseBorderOnPageBreakFormula, setDropShadow, setDropShadowFormula, setField, setForeColor, setForeColorFormula, setHorAlign, setHorAlignFormula, setHyperlinkUrl, setHyperlinkUrlFormula, setIndex, setLeftLineStyle, setLeftLineStyleFormula, setListStack, setReferences, 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, getKeepTogetherFormula, getRealReferencedObjectCount, getReferencedObjectCount, getReferencedObjects, getSuppressFormula, getType, getX, getY, isDOMParser, isKeepTogether, isSuppress, parseDOM, parseEndElement, removePropertyChangeListener, removePropertyChangeListener, removeReferencedObject, removeVetoableChangeListener, removeVetoableChangeListener, resetReferences, setBackColor, setBackColorFormula, setCustomData, setKeepTogether, setKeepTogetherFormula, setSuppress, setSuppressFormula, 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.BorderProperties
getBackColor, getBackColorFormula, getBottomLineStyleFormula, getCloseBorderOnPageBreakFormula, getDropShadowFormula, getForeColor, getForeColorFormula, getLeftLineStyleFormula, getRightLineStyleFormula, getTightHorizontalFormula, getTopLineStyleFormula, isDropShadow, isTightHorizontal, setBackColor, setBackColorFormula, setBottomLineStyle, setBottomLineStyleFormula, setCloseBorderOnPageBreakFormula, setDropShadow, setDropShadowFormula, setForeColor, setForeColorFormula, setLeftLineStyle, setLeftLineStyleFormula, setRightLineStyle, setRightLineStyleFormula, setTightHorizontal, setTightHorizontalFormula, setTopLineStyle, setTopLineStyleFormula
-
Methods inherited from interface com.inet.report.BoxProperties
getBackColor, getBackColorFormula, getCloseBorderOnPageBreakFormula, getDropShadowFormula, isDropShadow, setBackColor, setBackColorFormula, setCloseBorderOnPageBreakFormula, setDropShadow, setDropShadowFormula
-
Methods inherited from interface com.inet.report.GeneralProperties
getKeepTogetherFormula, getSuppressFormula, isKeepTogether, isSuppress, setKeepTogether, setKeepTogetherFormula, setSuppress, setSuppressFormula
-
Methods inherited from interface com.inet.report.HyperlinkProperties
getHyperlinkUrl, getHyperlinkUrlFormula, setHyperlinkUrl, setHyperlinkUrlFormula
-
Methods inherited from interface com.inet.report.LineProperties
getForeColor, getSuppressFormula, getX, getY, isSuppress, setForeColor, setSuppress, setSuppressFormula, setX, setY
-
-
-
-
Method Detail
-
getCornerEllipseHeight
public int getCornerEllipseHeight()
Returns the value of the property 'corner ellipse height'. This property allows you to round off the edges of the box. The result depends on the form of the box; if it was a square the result becomes more and more a circle with using greater values; if it was a rectangle it becomes an ellipse.- Specified by:
getCornerEllipseHeight
in interfaceBoxProperties
- Returns:
- The current value of the property 'corner ellipse height'.
- Since:
- 3.0
-
setCornerEllipseHeight
public void setCornerEllipseHeight(int newValue)
Sets the value of the property 'corner ellipse height'. This property allows you to round off the edges of the box. The result depends on the form of the box; if it was a square the result becomes more and more a circle with using greater values; if it was a rectangle it becomes an ellipse.- Specified by:
setCornerEllipseHeight
in interfaceBoxProperties
- Parameters:
newValue
- The new value of the property 'corner ellipse height'.- Throws:
java.lang.IllegalArgumentException
- if newValue is negative- Since:
- 3.0
-
getCornerEllipseWidth
public int getCornerEllipseWidth()
Returns the value of the property 'corner ellipse width'. This property allows you to round off the edges of the box. The result depends on the form of the box; if it was a square the result becomes more and more a circle with using greater values; if it was a rectangle it becomes an ellipse.- Specified by:
getCornerEllipseWidth
in interfaceBoxProperties
- Returns:
- The current value of the property 'corner ellipse width'.
- Since:
- 3.0
-
setCornerEllipseWidth
public void setCornerEllipseWidth(int newValue)
Sets the value of the property 'corner ellipse width'. This property allows you to round off the edges of the box. The result depends on the form of the box; if it was a square the result becomes more and more a circle with using greater values; if it was a rectangle it becomes an ellipse.- Specified by:
setCornerEllipseWidth
in interfaceBoxProperties
- Parameters:
newValue
- The new value of the property 'corner ellipse width'.- Throws:
java.lang.IllegalArgumentException
- if newValue is negative- Since:
- 3.0
-
isCloseBorderOnPageBreak
public boolean isCloseBorderOnPageBreak()
Returns the value of the property 'close border on page break'. If this property is enabled and if the element has a border and will break over two pages, then the border of both parts will be closed (on bottom of the first, on top of the second part). If not the borders of both parts will be partial (on bottom of the first, on top of the second part are no borders).- Specified by:
isCloseBorderOnPageBreak
in interfaceBorderProperties
- Specified by:
isCloseBorderOnPageBreak
in interfaceBoxProperties
- Overrides:
isCloseBorderOnPageBreak
in classElement
- Returns:
- FormulaField The value of the property 'close border on page break'.
-
setCloseBorderOnPageBreak
public void setCloseBorderOnPageBreak(boolean newValue)
Sets the value of the property 'close border on page break'. If this property is enabled and if the element has a border and will break over two pages, then the border of both parts will be closed (on bottom of the first, on top of the second part). If not the borders of both parts will be partial (on bottom of the first, on top of the second part are no borders).- Specified by:
setCloseBorderOnPageBreak
in interfaceBorderProperties
- Specified by:
setCloseBorderOnPageBreak
in interfaceBoxProperties
- Overrides:
setCloseBorderOnPageBreak
in classElement
- Parameters:
newValue
- The new value of the property 'close border on page break'.
-
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 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:
parseElement
in interfaceNodeParser
- Overrides:
parseElement
in classAbstractLineElement
- 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.
-
getSubComponents
public java.util.List<? extends ReportComponent> getSubComponents()
Returns allReportComponent
s that are descendants of this one. E.G. this will return all Element of aSection
. But it's as well useful forCrossTab
s orText
elements which have additional elements.- Specified by:
getSubComponents
in classReportComponent
- Returns:
- a list with all sub components which can be empty as well; will be
null
if the component has no descendants
-
-