org.jfree.chart.block

Class BlockContainer

public class BlockContainer extends AbstractBlock implements Block, Cloneable, PublicCloneable, Serializable

A container for a collection of Block objects. The container uses an Arrangement object to handle the position of each block.
Constructor Summary
BlockContainer()
Creates a new instance with default settings.
BlockContainer(Arrangement arrangement)
Creates a new instance with the specified arrangement.
Method Summary
voidadd(Block block)
Adds a block to the container.
voidadd(Block block, Object key)
Adds a block to the container.
Size2Darrange(Graphics2D g2, RectangleConstraint constraint)
Arranges the contents of the block, within the given constraints, and returns the block size.
voidclear()
Clears all the blocks from the container.
Objectclone()
Returns a clone of the container.
voiddraw(Graphics2D g2, Rectangle2D area)
Draws the container and all the blocks within it.
Objectdraw(Graphics2D g2, Rectangle2D area, Object params)
Draws the block within the specified area.
booleanequals(Object obj)
Tests this container for equality with an arbitrary object.
ArrangementgetArrangement()
Returns the arrangement (layout) manager for the container.
ListgetBlocks()
Returns an unmodifiable list of the Block objects managed by this arrangement.
booleanisEmpty()
Returns true if there are no blocks in the container, and false otherwise.
voidsetArrangement(Arrangement arrangement)
Sets the arrangement (layout) manager.

Constructor Detail

BlockContainer

public BlockContainer()
Creates a new instance with default settings.

BlockContainer

public BlockContainer(Arrangement arrangement)
Creates a new instance with the specified arrangement.

Parameters: arrangement the arrangement manager (null not permitted).

Method Detail

add

public void add(Block block)
Adds a block to the container.

Parameters: block the block (null permitted).

add

public void add(Block block, Object key)
Adds a block to the container.

Parameters: block the block (null permitted). key the key (null permitted).

arrange

public Size2D arrange(Graphics2D g2, RectangleConstraint constraint)
Arranges the contents of the block, within the given constraints, and returns the block size.

Parameters: g2 the graphics device. constraint the constraint (null not permitted).

Returns: The block size (in Java2D units, never null).

clear

public void clear()
Clears all the blocks from the container.

clone

public Object clone()
Returns a clone of the container.

Returns: A clone.

Throws: CloneNotSupportedException if there is a problem cloning.

draw

public void draw(Graphics2D g2, Rectangle2D area)
Draws the container and all the blocks within it.

Parameters: g2 the graphics device. area the area.

draw

public Object draw(Graphics2D g2, Rectangle2D area, Object params)
Draws the block within the specified area.

Parameters: g2 the graphics device. area the area. params passed on to blocks within the container (null permitted).

Returns: An instance of EntityBlockResult, or null.

equals

public boolean equals(Object obj)
Tests this container for equality with an arbitrary object.

Parameters: obj the object (null permitted).

Returns: A boolean.

getArrangement

public Arrangement getArrangement()
Returns the arrangement (layout) manager for the container.

Returns: The arrangement manager (never null).

getBlocks

public List getBlocks()
Returns an unmodifiable list of the Block objects managed by this arrangement.

Returns: A list of blocks.

isEmpty

public boolean isEmpty()
Returns true if there are no blocks in the container, and false otherwise.

Returns: A boolean.

setArrangement

public void setArrangement(Arrangement arrangement)
Sets the arrangement (layout) manager.

Parameters: arrangement the arrangement (null not permitted).