SourceForge.net Logo
aXSL API 0.2

org.axsl.area
Interface AreaNode

All Superinterfaces:
FoContext, javax.swing.tree.TreeNode
All Known Subinterfaces:
AbstractTablePartContainer, AncestralNormalInlineArea, Area, AreaTree, BeforeFloatRefArea, BlockContainerRefArea, BlockContentFactory, FootnoteRefArea, GlyphAreaSequence, InlineContainerArea, LineArea, ListBlockArea, ListItemArea, ListItemBodyContainer, ListItemLabelContainer, MainRefArea, NormalBlockArea, NormalFlowRefArea, NormalInlineArea, PageCollection, PageCollectionWrapper, RegionBodyRefArea, RegionRefArea, SpanRefArea, TableArea, TableBodyContainer, TableCellArea, TableFooterContainer, TableHeaderContainer, TableRowContainer

public interface AreaNode
extends javax.swing.tree.TreeNode, FoContext

Super-interface for all AreaTree content.


Method Summary
 Area ancestorArea()
          Returns this node's nearest ancestor Area.
 BlockContentFactory ancestorBlockContentFactory()
          Returns this node's nearest ancestor BlockContentFactory.
 NormalBlockArea ancestorNormalBlockArea()
          Returns this node's ancestor NormalBlockArea.
 TableArea ancestorTableArea()
          Returns this node's ancestor TableArea.
 java.lang.String getAreaName()
          Provides a name suitable for display purposes, but specifically intended to match the axsl-area-tree DTD.
 AreaTree getAreaTree()
          Returns the area tree.
 PageArea getPage()
          Returns this node's ancestor PageArea.
 boolean isFirstChildOfGeneratedBy()
          Indicates whether this node is the first child of its "generated-by".
 Area nearestArea()
          Returns this node if if it is an instance of Area, or, if not, the nearest ancestor node that is an instance of Area.
 Area nearestGeneratedByBlockLevelFo()
          Finds either "this" or the nearest ancestor area that was generated by a block-level formatting object.
 void removeChild(AreaNode areaNode)
          Remove a node from this node's children.
 int siblingIndex()
          Returns this node's position within the siblings.
 Fo traitGeneratedBy()
          Returns the FObj instance that generated this node.
 
Methods inherited from interface javax.swing.tree.TreeNode
children, getAllowsChildren, getChildAt, getChildCount, getIndex, getParent, isLeaf
 
Methods inherited from interface org.axsl.fo.FoContext
bpdAncestorBlockOrRa, getGraftingPoint, heightContainingBlock, ipdAncestorBlockArea, ipdAncestorBlockOrRa, ipdContainingRefArea, ipdParentArea, isFirst, isLast, tableWidth, widthContainingBlock
 

Method Detail

ancestorArea

Area ancestorArea()
Returns this node's nearest ancestor Area.

Returns:
This node's nearest ancestor Area, or null if this node has no parent, or if there is no Area in its ancestry.

siblingIndex

int siblingIndex()
Returns this node's position within the siblings.

Returns:
The 0-based index to "this" in the parent's children.

getPage

PageArea getPage()
Returns this node's ancestor PageArea.

Returns:
This node's ancestor PageArea, or null if this node is not on a page.

traitGeneratedBy

Fo traitGeneratedBy()
Returns the FObj instance that generated this node.

Returns:
The FObj that generated this node.

isFirstChildOfGeneratedBy

boolean isFirstChildOfGeneratedBy()
Indicates whether this node is the first child of its "generated-by".

Returns:
True iff this node is the first child of its "generated-by".

ancestorNormalBlockArea

NormalBlockArea ancestorNormalBlockArea()
Returns this node's ancestor NormalBlockArea.

Returns:
This node's ancestor NormalBlockArea, or null if this node is not in a NormalBlockArea. A NormalBlockArea should not return itself.

ancestorTableArea

TableArea ancestorTableArea()
Returns this node's ancestor TableArea.

Returns:
This node's ancestor TableArea, or null if this node is not contained in a TableArea. A TableArea should not return itself, but should return its own ancestor TableArea, if any.

ancestorBlockContentFactory

BlockContentFactory ancestorBlockContentFactory()
Returns this node's nearest ancestor BlockContentFactory. This method is needed for FOs like inline and basic-link that contain block% content, but whose corresponding Areas in the AreaTree cannot contain the Areas that are generated by block% content. In these cases, the block% content must be laid out in some ancestor Area that can hold such areas.

Returns:
This node's ancestor BlockContentFactory, or null if no such ancestor exists. A BlockContentFactory should not return itself.

removeChild

void removeChild(AreaNode areaNode)
Remove a node from this node's children. This will have no effect unless the node to be removed is a child of this node.

Parameters:
areaNode - The node to be removed.

nearestGeneratedByBlockLevelFo

Area nearestGeneratedByBlockLevelFo()
Finds either "this" or the nearest ancestor area that was generated by a block-level formatting object.

Returns:
The Area generated by a block-level FO.

getAreaTree

AreaTree getAreaTree()
Returns the area tree.

Returns:
The area tree.

getAreaName

java.lang.String getAreaName()
Provides a name suitable for display purposes, but specifically intended to match the axsl-area-tree DTD.

Returns:
The name of this node, as it is provided in the axsl-area-tree DTD.

nearestArea

Area nearestArea()
Returns this node if if it is an instance of Area, or, if not, the nearest ancestor node that is an instance of Area.

Returns:
The nearest Area, which can be this.

SourceForge.net Logo
aXSL API 0.2

This documentation was created August 8 2007 by The aXSL Group and may be freely copied. See license for details.