org.foray.area
Class TableRA

java.lang.Object
  org.foray.common.AbstractOrderedTreeNode
      org.foray.area.AreaNode
          org.foray.area.Area
              org.foray.area.AreaFlexible
                  org.foray.area.ContainerRA
                      org.foray.area.TableRA

All Implemented Interfaces:

Iterable<org.axsl.galley.AreaNode>, TreeNode, org.axsl.area.Area, org.axsl.area.AreaNode, org.axsl.area.TableArea, org.axsl.fo.FoContext, org.axsl.galley.BackgroundArea, org.axsl.galley.BorderPaddingArea, org.axsl.galley.GraphicArea, OrderedTreeNode

public final class TableRA
extends ContainerRA
implements org.axsl.galley.TableArea, org.axsl.area.TableArea

Area containing part or all of a Table.

Nested Class Summary

Nested classes/interfaces inherited from class org.foray.common.AbstractOrderedTreeNode

AbstractOrderedTreeNode.PostOrderDescendantIterator

Method Summary

TableRA	ancestorTableArea() Overrides the AreaNode method, because this is the TableRA being sought.
void	calcColumnOrigins() Computes the content-rectangle point-of-origin "X" value for a column in this table.
org.axsl.common.value.RelativeAxis	contentStackingAxis() Returns the content stacking axis for this area.
int	crBpd()
int	crIpd()
String	getAreaName()
org.axsl.galley.BackgroundArea[]	getBackgroundAreas()
List<AbstractTablePartContainer>	getChildren() Return the List of this node's children.
org.axsl.graphic.Graphic	getGraphic()
FOLinkage	getLinkage() Returns the raw "generated by" instance.
Area	getOverflowArea(Area area) This method is used by child Areas to ask the parent Area into which Area the child Area's overflow should be placed.
AreaNode	getParent()
int	getProgressionDimension() Returns the actual total value, in millipoints, of the size of this area (not counting space-before, etc.) in its progression direction.
int	getResolvedColumnWidth(int columnNumber) Returns the resolved width of a given column.
int	getResolvedGridIPD(int startingColumn, int inputNumberColumns) Computes the IPD of the grid area for a cell.
int	getResolvedGridOriginX(int columnNumber) Returns the resolved "X" value for the point-of-origin of a given column.
TableBodyContainer	getTableBodyContainer()
TableFooterContainer	getTableFooterContainer()
TableHeaderContainer	getTableHeaderContainer()
void	incrementProgressionDimension(int incrementAmount) Change the progression-dimension used by this Area.
boolean	isAbsolutelyPositioned() Indicates whether this Area is positioned absolutely or relatively.
TableBodyContainer	makeTableBodyContainer(org.axsl.fo.fo.TableBody tableBody, org.axsl.fo.fo.GraftingPoint graftingPoint)
TableFooterContainer	makeTableFooterContainer(org.axsl.fo.fo.TableFooter tableFooter, org.axsl.fo.fo.GraftingPoint graftingPoint)
TableHeaderContainer	makeTableHeaderContainer(org.axsl.fo.fo.TableHeader tableHeader, org.axsl.fo.fo.GraftingPoint graftingPoint)
protected boolean	optimize() This method should be run after layout is complete, allowing cleanup and adjustments that do not affect the placement of the areas to be computed before the page is rendered.
void	render(org.axsl.galley.RenderVisitor visitor)
void	setParent(AreaNode node) Sets the parent node.
void	setProgressionDimension(int progressionDimension) Sets the progression-dimension used by this Area.
Color	traitBackgroundColor()
org.axsl.graphic.Graphic	traitBackgroundImage()
org.axsl.common.value.BackgroundRepeat	traitBackgroundRepeat()
Color	traitBorderAfterColor()
org.axsl.common.value.BorderStyle	traitBorderAfterStyle() Returns the border style for the "after" edge of this Area.
int	traitBorderAfterWidth() Returns the border-after-width trait for this area.
Color	traitBorderBeforeColor()
org.axsl.common.value.BorderStyle	traitBorderBeforeStyle() Returns the border style for the "before" edge of this Area.
int	traitBorderBeforeWidth() Returns the border-before-width trait for this area.
org.axsl.common.value.BorderModel	traitBorderCollapse() Returns the border-collapse trait for this Area.
Color	traitBorderEndColor()
org.axsl.common.value.BorderStyle	traitBorderEndStyle() Returns the border style for the "end" edge of this Area.
int	traitBorderEndWidth() Returns the border-end-width trait for this area.
int	traitBorderSeparationBPD() Returns the BPD portion of the border separation trait for this Area.
int	traitBorderSeparationIPD() Returns the IPD portion of the border separation trait for this Area.
Color	traitBorderStartColor()
org.axsl.common.value.BorderStyle	traitBorderStartStyle() Returns the border style for the "start" edge of this Area.
int	traitBorderStartWidth() Returns the border-start-width trait for this area.
int	traitEndIndent() Returns the end-indent trait.
org.axsl.fo.fo.Table	traitGeneratedBy()
int	traitIPDimensionOpt() Return the optimum IP dimension for this area.
int	traitPaddingAfter() Returns the padding-after trait for this area.
int	traitPaddingBefore() Returns the padding-before trait for this area.
int	traitPaddingEnd() Returns the padding-end trait for this area.
int	traitPaddingStart() Returns the padding-start trait for this area.
int	traitSpaceAfterOptimum() Returns the space-after optimum trait for this area.
int	traitSpaceBeforeOptimum() Returns the space-before optimum trait for this area.
int	traitSpaceEndOptimum() Returns the space-end optimum trait for this area.
int	traitSpaceStartOptimum() Returns the space-start optimum trait for this area.
int	traitStartIndent() Returns the start-indent trait.

Methods inherited from class org.foray.area.AreaFlexible

computeInitialPD, crIPDBlockArea, crOriginBPDOffset, crOriginIPDOffset, getAnteriorSpace, incrementAnteriorSpace, incrementParentPD, initializeAnteriorSpace, pdAvailable, pdUsedBySiblings, removeChild, setAnteriorSpace, setMinimumProgressionDimension, setParentPD, usedProgressionDimension, usedProgressionDimensionNormalFlow

Methods inherited from class org.foray.area.Area

brBpd, brIpd, brOriginBPDOffset, brOriginIPDOffset, brOriginX, brOriginY, brPoints, contentStackingAxisAbsolute, contentStackingDirectionAbsolute, crOriginX, crOriginY, crPoints, destinationName, generatedByExists, generatedByName, getAreaParent, getBPAxis, getFontWritingMode, getIPAxis, getNearestAncestorAreaContainer, getWritingMode, hasFenceFollowing, hasFencePreceding, isBlockArea, isFirstChildOfParent, isInNormalFlow, isLastChildOfParent, isLinkRoot, larBPD, larIPD, larOriginX, larOriginY, linkDestination, linkType, narBPD, narIPD, narOriginX, narOriginY, nearestArea, parentAllocationWidth, prBpd, prIpd, prOriginBPDOffset, prOriginIPDOffset, prOriginX, prOriginY, referenceOrientationCumulative, shouldAdjustParentPD, traitAreaClass, traitId, traitIsFirst, traitIsLast, traitIsReferenceArea, traitWhiteSpaceTreatment

Methods inherited from class org.foray.area.AreaNode

ancestorArea, ancestorBlockAreaNotALineArea, ancestorBlockContentFactory, ancestorBlockOrRa, ancestorGeneratedByBlockLevelFO, ancestorLineArea, ancestorNormalBlockArea, ancestorPageCollection, ancestorReferenceArea, ancestorSpanRA, bpdAncestorBlockOrRa, getAllowsChildren, getAreaTree, getChildAt, getColor, getContainingReferenceArea, getFirstAreaChild, getFirstChild, getGalley, getGraftingPoint, getLastAreaChild, getLastChild, getLogger, getNextChildOfGeneratedBy, getNextSiblingArea, getNormalLinkage, getNormalLinkage, getOrderedParent, getPage, getPreviousChildOfGeneratedBy, getPreviousSiblingArea, getSiblings, hasUnresolvedRefId, heightContainingBlock, ipdAncestorBlockArea, ipdAncestorBlockOrRa, ipdContainingRefArea, ipdParentArea, isFirst, isFirstChildOfGeneratedBy, isGeneratedByBlockLevelFo, isLast, isLastChildOfGeneratedBy, iterator, linkage, nearestBeforeFloatArea, nearestFootnoteArea, nearestGeneratedByBlockLevelFo, nearestNormalBlockArea, nearestTableArea, optimizeChildren, registerWithLinkage, remove, removeChild, tableWidth, widthContainingBlock

Methods inherited from class org.foray.common.AbstractOrderedTreeNode

children, getChildCount, getFirstLeaf, getIndex, getLastLeaf, getLevel, getNextLeaf, getNextSibling, getPreviousLeaf, getPreviousSibling, getSharedAncestor, hasChildren, isLeaf, isNodeAncestor, isNodeDescendant, nextPostOrderNode, nextPreOrderNode, postOrderDescendantIterator, siblingIndex

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.axsl.galley.BackgroundArea

prBpd, prIpd, prOriginX, prOriginY

Methods inherited from interface org.axsl.galley.Area

brBpd, brIpd, brOriginX, brOriginY, crOriginX, crOriginY, destinationName, generatedByExists, generatedByName, isLinkRoot, linkDestination, linkType, traitId

Methods inherited from interface org.axsl.galley.AreaNode

getGalley

Methods inherited from interface javax.swing.tree.TreeNode

children, getAllowsChildren, getChildCount, getIndex, isLeaf

Methods inherited from interface java.lang.Iterable

iterator

Methods inherited from interface org.axsl.area.Area

pdAvailable

Methods inherited from interface org.axsl.area.AreaNode

ancestorArea, ancestorBlockContentFactory, ancestorNormalBlockArea, getAreaTree, getPage, isFirstChildOfGeneratedBy, nearestArea, nearestGeneratedByBlockLevelFo, removeChild, siblingIndex

Methods inherited from interface org.axsl.fo.FoContext

bpdAncestorBlockOrRa, getGraftingPoint, heightContainingBlock, ipdAncestorBlockArea, ipdAncestorBlockOrRa, ipdContainingRefArea, ipdParentArea, isFirst, isLast, tableWidth, widthContainingBlock

Method Detail

getResolvedGridIPD

public int getResolvedGridIPD(int startingColumn,
                              int inputNumberColumns)

Computes the IPD of the grid area for a cell.

Parameters:

startingColumn - The 1-based index to the column number.

inputNumberColumns - The number of columns to be computed (useful for spanned columns).

Returns:

The IPD of the grid area contained by the described cell. Note that the grid area is NOT the same as the content-rectangle. See XSL-FO 1.1, Section 6.7.10, Subsection "Constraints" for the definition of the table-cell content-rectangle.

ancestorTableArea

public TableRA ancestorTableArea()

Overrides the AreaNode method, because this is the TableRA being sought.

Specified by:

ancestorTableArea in interface org.axsl.area.AreaNode

Overrides:

ancestorTableArea in class AreaNode

getResolvedColumnWidth

public int getResolvedColumnWidth(int columnNumber)

Returns the resolved width of a given column. The value returned here can be different from the nominal column-width returned by ColumnWidthPa.traitColumnWidth(FoContext) because of allocation of excesses or deficiencies in the table width.

Parameters:

columnNumber - The column whose resolved width is needed.

Returns:

The computed column-width, in millipoints.

getResolvedGridOriginX

public int getResolvedGridOriginX(int columnNumber)

Returns the resolved "X" value for the point-of-origin of a given column. Note that the grid area is NOT the same as the content-rectangle. See XSL-FO 1.1, Section 6.7.10, Subsection "Constraints" for the definition of the table-cell content-rectangle.

Parameters:

columnNumber - The column whose resolved point-of-origin is needed.

Returns:

The "X" coordinate of the point-of-origin, in millipoints.

makeTableBodyContainer

public TableBodyContainer makeTableBodyContainer(org.axsl.fo.fo.TableBody tableBody,
                                                 org.axsl.fo.fo.GraftingPoint graftingPoint)

Specified by:

makeTableBodyContainer in interface org.axsl.area.TableArea

makeTableHeaderContainer

public TableHeaderContainer makeTableHeaderContainer(org.axsl.fo.fo.TableHeader tableHeader,
                                                     org.axsl.fo.fo.GraftingPoint graftingPoint)

Specified by:

makeTableHeaderContainer in interface org.axsl.area.TableArea

makeTableFooterContainer

public TableFooterContainer makeTableFooterContainer(org.axsl.fo.fo.TableFooter tableFooter,
                                                     org.axsl.fo.fo.GraftingPoint graftingPoint)

Specified by:

makeTableFooterContainer in interface org.axsl.area.TableArea

getAreaName

public String getAreaName()

Specified by:

getAreaName in interface org.axsl.area.AreaNode

getOverflowArea

public Area getOverflowArea(Area area)

Description copied from class: Area

This method is used by child Areas to ask the parent Area into which Area the child Area's overflow should be placed. Overflows start when a new LineArea cannot be create for the current BlockArea. General strategy for overflow is to recursively go up the tree until getting to any Area that knows how to solve the overflow. One general case is the page-reference-area, which should know how to create a new page.

Specified by:

getOverflowArea in class Area

Parameters:

area - Child Areas ask

Returns:

The younger sister Area that should be used to handle the overflow condition.

calcColumnOrigins

public void calcColumnOrigins()

Computes the content-rectangle point-of-origin "X" value for a column in this table.

getBackgroundAreas

public org.axsl.galley.BackgroundArea[] getBackgroundAreas()

render

public void render(org.axsl.galley.RenderVisitor visitor)
            throws org.axsl.galley.GalleyVisitorException

Throws:

org.axsl.galley.GalleyVisitorException

crBpd

public int crBpd()

Specified by:

crBpd in interface org.axsl.area.Area

Specified by:

crBpd in class Area

crIpd

public int crIpd()

Specified by:

crIpd in interface org.axsl.area.Area

Specified by:

crIpd in class Area

contentStackingAxis

public org.axsl.common.value.RelativeAxis contentStackingAxis()

Description copied from class: Area

Returns the content stacking axis for this area.

Specified by:

contentStackingAxis in class Area

Returns:

Either RelativeAxis.BLOCK_PROGRESSION or RelativeAxis.INLINE_PROGRESSION, depending on whether the contents of this area stack in the block-progression-direction or the inline-progression-direction. The default value is that contents stack in the BPD. Classes that stack in the IPD should override this method.

getParent

public AreaNode getParent()

Specified by:

getParent in interface TreeNode

Specified by:

getParent in class AreaNode

setParent

public void setParent(AreaNode node)
               throws org.axsl.area.AreaTreeException

Description copied from class: AreaNode

Sets the parent node.

Specified by:

setParent in class AreaNode

Parameters:

node - The new parent node.

Throws:

org.axsl.area.AreaTreeException - If the parent node is not compatible with the implementations specification for a parent node.

getChildren

public List<AbstractTablePartContainer> getChildren()

Description copied from class: AbstractOrderedTreeNode

Return the List of this node's children.

Specified by:

getChildren in class AreaNode

Returns:

The List of this node's children.

setProgressionDimension

public void setProgressionDimension(int progressionDimension)

Description copied from class: Area

Sets the progression-dimension used by this Area.

Specified by:

setProgressionDimension in class Area

Parameters:

progressionDimension - The new progression-dimension value for this Area.

incrementProgressionDimension

public void incrementProgressionDimension(int incrementAmount)

Description copied from class: Area

Change the progression-dimension used by this Area.

Specified by:

incrementProgressionDimension in class Area

Parameters:

incrementAmount - The amount by which the progression-dimension should be changed for this area. Positive values increase the progression-dimension, negative values decrease it.

getProgressionDimension

public int getProgressionDimension()

Description copied from class: Area

Returns the actual total value, in millipoints, of the size of this area (not counting space-before, etc.) in its progression direction. This value does not include space-before, etc., but does include borders and padding. For block areas, the progression dimension is the block-progression-dimension. For inline areas, it is the inline-progression-dimension.

Specified by:

getProgressionDimension in class Area

Returns:

The progressionDimension.

getGraphic

public org.axsl.graphic.Graphic getGraphic()

Specified by:

getGraphic in interface org.axsl.galley.GraphicArea

optimize

protected boolean optimize()

Description copied from class: AreaNode

This method should be run after layout is complete, allowing cleanup and adjustments that do not affect the placement of the areas to be computed before the page is rendered. For example, empty areas should be removed. Also classes like LineArea can use this to adjust word-spacing and other variables. NOTE: This method is called recursively by each node. The process starts at PageRA.layoutComplete().

Specified by:

optimize in class AreaNode

Returns:

True iff the Area node thinks it should be removed.

getLinkage

public FOLinkage getLinkage()

Description copied from class: AreaNode

Returns the raw "generated by" instance.

Specified by:

getLinkage in class AreaNode

Returns:

The raw linkage item.

traitGeneratedBy

public org.axsl.fo.fo.Table traitGeneratedBy()

Specified by:

traitGeneratedBy in interface org.axsl.area.AreaNode

Specified by:

traitGeneratedBy in interface org.axsl.area.TableArea

Specified by:

traitGeneratedBy in class AreaNode

getTableBodyContainer

public TableBodyContainer getTableBodyContainer()

Specified by:

getTableBodyContainer in interface org.axsl.area.TableArea

getTableHeaderContainer

public TableHeaderContainer getTableHeaderContainer()

Specified by:

getTableHeaderContainer in interface org.axsl.area.TableArea

getTableFooterContainer

public TableFooterContainer getTableFooterContainer()

Specified by:

getTableFooterContainer in interface org.axsl.area.TableArea

traitBorderCollapse

public org.axsl.common.value.BorderModel traitBorderCollapse()

Returns the border-collapse trait for this Area.

Returns:

The border-collapse trait for this Area.

traitBorderSeparationIPD

public int traitBorderSeparationIPD()

Returns the IPD portion of the border separation trait for this Area.

Returns:

The IPD portion of the border separation trait for this Area.

traitBorderSeparationBPD

public int traitBorderSeparationBPD()

Returns the BPD portion of the border separation trait for this Area.

Returns:

The BPD portion of the border separation trait for this Area.

isAbsolutelyPositioned

public boolean isAbsolutelyPositioned()

Description copied from class: Area

Indicates whether this Area is positioned absolutely or relatively.

Specified by:

isAbsolutelyPositioned in class Area

Returns:

True iff this Area is absolutely positioned.

traitBackgroundImage

public org.axsl.graphic.Graphic traitBackgroundImage()

Specified by:

traitBackgroundImage in interface org.axsl.galley.BackgroundArea

traitBackgroundColor

public Color traitBackgroundColor()

Specified by:

traitBackgroundColor in interface org.axsl.galley.BackgroundArea

traitBackgroundRepeat

public org.axsl.common.value.BackgroundRepeat traitBackgroundRepeat()

Specified by:

traitBackgroundRepeat in interface org.axsl.galley.BackgroundArea

traitBorderBeforeColor

public Color traitBorderBeforeColor()

Specified by:

traitBorderBeforeColor in interface org.axsl.galley.BorderPaddingArea

traitBorderStartColor

public Color traitBorderStartColor()

Specified by:

traitBorderStartColor in interface org.axsl.galley.BorderPaddingArea

traitBorderEndColor

public Color traitBorderEndColor()

Specified by:

traitBorderEndColor in interface org.axsl.galley.BorderPaddingArea

traitBorderAfterColor

public Color traitBorderAfterColor()

Specified by:

traitBorderAfterColor in interface org.axsl.galley.BorderPaddingArea

traitBorderStartStyle

public org.axsl.common.value.BorderStyle traitBorderStartStyle()

Returns the border style for the "start" edge of this Area.

Specified by:

traitBorderStartStyle in interface org.axsl.galley.BorderPaddingArea

Returns:

The border style for the "start" edge of this Area.

traitBorderEndStyle

public org.axsl.common.value.BorderStyle traitBorderEndStyle()

Returns the border style for the "end" edge of this Area.

Specified by:

traitBorderEndStyle in interface org.axsl.galley.BorderPaddingArea

Returns:

The border style for the "end" edge of this Area.

traitBorderBeforeStyle

public org.axsl.common.value.BorderStyle traitBorderBeforeStyle()

Returns the border style for the "before" edge of this Area.

Specified by:

traitBorderBeforeStyle in interface org.axsl.galley.BorderPaddingArea

Returns:

The border style for the "before" edge of this Area.

traitBorderAfterStyle

public org.axsl.common.value.BorderStyle traitBorderAfterStyle()

Returns the border style for the "after" edge of this Area.

Specified by:

traitBorderAfterStyle in interface org.axsl.galley.BorderPaddingArea

Returns:

The border style for the "after" edge of this Area.

traitBorderStartWidth

public int traitBorderStartWidth()

Description copied from class: Area

Returns the border-start-width trait for this area.

Specified by:

traitBorderStartWidth in interface org.axsl.galley.BorderPaddingArea

Specified by:

traitBorderStartWidth in class Area

Returns:

The border-start-width trait for this area.

traitBorderEndWidth

public int traitBorderEndWidth()

Description copied from class: Area

Returns the border-end-width trait for this area.

Specified by:

traitBorderEndWidth in interface org.axsl.galley.BorderPaddingArea

Specified by:

traitBorderEndWidth in class Area

Returns:

The border-end-width trait for this area.

traitBorderBeforeWidth

public int traitBorderBeforeWidth()

Description copied from class: Area

Returns the border-before-width trait for this area.

Specified by:

traitBorderBeforeWidth in interface org.axsl.galley.BorderPaddingArea

Specified by:

traitBorderBeforeWidth in class Area

Returns:

The border-before-width trait for this area.

traitBorderAfterWidth

public int traitBorderAfterWidth()

Description copied from class: Area

Returns the border-after-width trait for this area.

Specified by:

traitBorderAfterWidth in interface org.axsl.galley.BorderPaddingArea

Specified by:

traitBorderAfterWidth in class Area

Returns:

The border-after-width trait for this area.

traitPaddingStart

public int traitPaddingStart()

Description copied from class: Area

Returns the padding-start trait for this area.

Specified by:

traitPaddingStart in class Area

Returns:

The padding-start trait for this area.

traitPaddingEnd

public int traitPaddingEnd()

Description copied from class: Area

Returns the padding-end trait for this area.

Specified by:

traitPaddingEnd in class Area

Returns:

The padding-end trait for this area.

traitPaddingBefore

public int traitPaddingBefore()

Description copied from class: Area

Returns the padding-before trait for this area.

Specified by:

traitPaddingBefore in class Area

Returns:

The padding-before trait for this area.

traitPaddingAfter

public int traitPaddingAfter()

Description copied from class: Area

Returns the padding-after trait for this area.

Specified by:

traitPaddingAfter in class Area

Returns:

The padding-after trait for this area.

traitSpaceBeforeOptimum

public int traitSpaceBeforeOptimum()

Description copied from class: Area

Returns the space-before optimum trait for this area.

Specified by:

traitSpaceBeforeOptimum in class Area

Returns:

The space-before optimum trait for this area.

traitSpaceAfterOptimum

public int traitSpaceAfterOptimum()

Description copied from class: Area

Returns the space-after optimum trait for this area.

Specified by:

traitSpaceAfterOptimum in class Area

Returns:

The space-after optimum trait for this area.

traitEndIndent

public int traitEndIndent()

Description copied from class: Area

Returns the end-indent trait.

Specified by:

traitEndIndent in class Area

Returns:

The end-indent trait.

traitStartIndent

public int traitStartIndent()

Description copied from class: Area

Returns the start-indent trait.

Specified by:

traitStartIndent in class Area

Returns:

The start-indent trait.

traitSpaceStartOptimum

public int traitSpaceStartOptimum()

Description copied from class: Area

Returns the space-start optimum trait for this area.

Specified by:

traitSpaceStartOptimum in class Area

Returns:

The space-start optimum trait for this area.

traitSpaceEndOptimum

public int traitSpaceEndOptimum()

Description copied from class: Area

Returns the space-end optimum trait for this area.

Specified by:

traitSpaceEndOptimum in class Area

Returns:

The space-end optimum trait for this area.

traitIPDimensionOpt

public int traitIPDimensionOpt()

Description copied from class: AreaFlexible

Return the optimum IP dimension for this area.

Specified by:

traitIPDimensionOpt in class AreaFlexible

Returns:

The optimum IP dimension for this area, or -1 for "auto".