org.odftoolkit.simple.text
Class AbstractParagraphContainer

java.lang.Object
  extended by org.odftoolkit.simple.text.AbstractParagraphContainer
All Implemented Interfaces:
ParagraphContainer

public abstract class AbstractParagraphContainer
extends Object
implements ParagraphContainer

AbstractParagraphContainer is an abstract class to present paragraph container. It contains the default implementation to add/get/remove paragraph. Each subclass needs to implement getParagraphContainerElement().

Since:
0.5

Constructor Summary
AbstractParagraphContainer()
           
 
Method Summary
 Paragraph addParagraph(String textContent)
          Add paragraph at the end of the container with specified text content.
 Paragraph getParagraphByIndex(int index, boolean isEmptyParagraphSkipped)
          Return a paragraph with a given index.
 Paragraph getParagraphByReverseIndex(int reverseIndex, boolean isEmptyParagraphSkipped)
          Return a paragraph with a given index.
abstract  OdfElement getParagraphContainerElement()
          Get the ODF element which can have as child element directly.
 Iterator<Paragraph> getParagraphIterator()
          Return an Iterator of the paragraph in this container.
 boolean removeParagraph(Paragraph para)
          Remove paragraph from the container
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AbstractParagraphContainer

public AbstractParagraphContainer()
Method Detail

getParagraphContainerElement

public abstract OdfElement getParagraphContainerElement()
Description copied from interface: ParagraphContainer
Get the ODF element which can have as child element directly.

Specified by:
getParagraphContainerElement in interface ParagraphContainer
Returns:
- an ODF element which can have paragraph as child

addParagraph

public Paragraph addParagraph(String textContent)
Add paragraph at the end of the container with specified text content.

Specified by:
addParagraph in interface ParagraphContainer
Parameters:
textContent - the text content
Returns:
an instance of paragraph

removeParagraph

public boolean removeParagraph(Paragraph para)
Remove paragraph from the container

Specified by:
removeParagraph in interface ParagraphContainer
Parameters:
para - the instance of paragraph
Returns:
true if the paragraph is removed successfully, false if errors happen.

getParagraphIterator

public Iterator<Paragraph> getParagraphIterator()
Return an Iterator of the paragraph in this container.

Specified by:
getParagraphIterator in interface ParagraphContainer
Returns:
an Iterator of the paragraph in this container

getParagraphByIndex

public Paragraph getParagraphByIndex(int index,
                                     boolean isEmptyParagraphSkipped)
Return a paragraph with a given index.

An index of zero represents the first paragraph.

If empty paragraph is skipped, the empty paragraph won't be counted.

Specified by:
getParagraphByIndex in interface ParagraphContainer
Parameters:
index - the index started from 0.
isEmptyParagraphSkipped - whether the empty paragraph is skipped or not.
Returns:
the paragraph with a given index

getParagraphByReverseIndex

public Paragraph getParagraphByReverseIndex(int reverseIndex,
                                            boolean isEmptyParagraphSkipped)
Return a paragraph with a given index. The index is in reverse order.

An index of zero represents the last paragraph.

If empty paragraph is skipped, the empty paragraph won't be counted.

Specified by:
getParagraphByReverseIndex in interface ParagraphContainer
Parameters:
reverseIndex - the index started from 0 in reverse order.
isEmptyParagraphSkipped - whether the empty paragraph is skipped or not.
Returns:
the paragraph with a given index.


Copyright © 2010-2011 The Apache Software Foundation. All Rights Reserved.