org.apache.poi.xwpf.usermodel

Class XWPFAbstractFootnoteEndnote

java.lang.Object

org.apache.poi.xwpf.usermodel.XWPFAbstractFootnoteEndnote

All Implemented Interfaces:

Iterable<XWPFParagraph>, IBody

Direct Known Subclasses:

XWPFEndnote, XWPFFootnote

public abstract class XWPFAbstractFootnoteEndnote
extends Object
implements Iterable<XWPFParagraph>, IBody

Base class for both bottom-of-the-page footnotes XWPFFootnote and end notes XWPFEndnote).

The only significant difference between footnotes and end notes is which part they go on. Footnotes are managed by the Footnotes part XWPFFootnotes and end notes are managed by the Endnotes part XWPFEndnotes.

Since:

4.0.0

Field Summary

Fields

Modifier and Type	Field and Description
protected org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn	ctFtnEdn
protected XWPFDocument	document
protected XWPFAbstractFootnotesEndnotes	footnotes

Constructor Summary

Constructors

Modifier	Constructor and Description
	XWPFAbstractFootnoteEndnote()
protected	XWPFAbstractFootnoteEndnote(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn note, XWPFAbstractFootnotesEndnotes footnotes)
protected	XWPFAbstractFootnoteEndnote(XWPFDocument document, org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn body)

Method Summary

Modifier and Type	Method and Description
XWPFParagraph	addNewParagraph(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTP paragraph) Add a new XWPFParagraph to the end of the footnote.
XWPFTable	addNewTbl(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTbl table) Add a new XWPFTable to the end of the footnote.
XWPFParagraph	createParagraph() Appends a new XWPFParagraph to this footnote.
XWPFTable	createTable() Appends a new XWPFTable to this footnote
XWPFTable	createTable(int rows, int cols) Appends a new XWPFTable to this footnote
abstract void	ensureFootnoteRef(XWPFParagraph p) Ensure that the specified paragraph has a reference marker for this footnote by adding a footnote reference if one is not found.
List<IBodyElement>	getBodyElements() Gets the body elements (IBodyElement) of the footnote.
org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn	getCTFtnEdn() Gets the underlying CTFtnEdn object for the footnote.
BigInteger	getId() Get the ID of the footnote.
POIXMLDocumentPart	getOwner() The owning object for this footnote
XWPFParagraph	getParagraph(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTP p) Returns the paragraph corresponding to the provided CTP.
XWPFParagraph	getParagraphArray(int pos) Returns the XWPFParagraph at position pos in footnote's paragraph array.
List<XWPFParagraph>	getParagraphs() Get the list of XWPFParagraphs in the footnote.
POIXMLDocumentPart	getPart() Get the Part to which the footnote belongs, which you need for adding relationships to other parts
BodyType	getPartType() Get the part type BodyType of the footnote.
List<XWPFPictureData>	getPictures() Gets the list of XWPFPictureDatas in the footnote.
XWPFTable	getTable(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTbl ctTable) if there is a corresponding XWPFTable of the parameter ctTable in the tableList of this header the method will return this table, or null if there is no corresponding XWPFTable.
XWPFTable	getTableArray(int pos) Gets the XWPFTable at the specified position from the footnote's table array.
XWPFTableCell	getTableCell(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTc cell) get the XWPFTableCell that belongs to the CTTc cell.
List<XWPFTable>	getTables() Get the list of XWPFTables in the footnote.
XWPFDocument	getXWPFDocument() Get the XWPFDocument the footnote is part of.
protected void	init()
XWPFParagraph	insertNewParagraph(org.apache.xmlbeans.XmlCursor cursor) Add a new XWPFParagraph at position of the cursor.
XWPFTable	insertNewTbl(org.apache.xmlbeans.XmlCursor cursor) Insert a table constructed from OOXML table markup.
void	insertTable(int pos, XWPFTable table) Inserts an existing XWPFTable into the arrays bodyElements and tables.
Iterator<XWPFParagraph>	iterator() Get an iterator over the XWPFParagraphs in the footnote.
void	setCTFtnEdn(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn footnote) Set the underlying CTFtnEdn for the footnote.
Spliterator<XWPFParagraph>	spliterator() Get a spliterator over the XWPFParagraphs in the footnote.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

ctFtnEdn

protected org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn ctFtnEdn

footnotes

protected XWPFAbstractFootnotesEndnotes footnotes

document

protected XWPFDocument document

Constructor Detail

XWPFAbstractFootnoteEndnote

public XWPFAbstractFootnoteEndnote()

XWPFAbstractFootnoteEndnote

@Internal
protected XWPFAbstractFootnoteEndnote(XWPFDocument document,
                                                org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn body)

XWPFAbstractFootnoteEndnote

@Internal
protected XWPFAbstractFootnoteEndnote(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn note,
                                                XWPFAbstractFootnotesEndnotes footnotes)

Method Detail

init

protected void init()

getParagraphs

public List<XWPFParagraph> getParagraphs()

Get the list of XWPFParagraphs in the footnote.

Specified by:

getParagraphs in interface IBody

Returns:

List of paragraphs

iterator

public Iterator<XWPFParagraph> iterator()

Get an iterator over the XWPFParagraphs in the footnote.

Specified by:

iterator in interface Iterable<XWPFParagraph>

Returns:

Iterator over the paragraph list.

spliterator

public Spliterator<XWPFParagraph> spliterator()

Get a spliterator over the XWPFParagraphs in the footnote.

Specified by:

spliterator in interface Iterable<XWPFParagraph>

Returns:

Spliterator over the paragraph list.

Since:

POI 5.2.0

getTables

public List<XWPFTable> getTables()

Get the list of XWPFTables in the footnote.

Specified by:

getTables in interface IBody

Returns:

List of tables

getPictures

public List<XWPFPictureData> getPictures()

Gets the list of XWPFPictureDatas in the footnote.

Returns:

List of pictures

getBodyElements

public List<IBodyElement> getBodyElements()

Gets the body elements (IBodyElement) of the footnote.

Specified by:

getBodyElements in interface IBody

Returns:

List of body elements.

getCTFtnEdn

public org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn getCTFtnEdn()

Gets the underlying CTFtnEdn object for the footnote.

Returns:

CTFtnEdn object

setCTFtnEdn

public void setCTFtnEdn(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFtnEdn footnote)

Set the underlying CTFtnEdn for the footnote.

Use XWPFDocument.createFootnote() to create new footnotes.

Parameters:

footnote - The CTFtnEdn object that will underly the footnote.

getTableArray

public XWPFTable getTableArray(int pos)

Gets the XWPFTable at the specified position from the footnote's table array.

Specified by:

getTableArray in interface IBody

Parameters:

pos - in table array

Returns:

The XWPFTable at position pos, or null if there is no table at position pos.

insertTable

public void insertTable(int pos,
                        XWPFTable table)

Inserts an existing XWPFTable into the arrays bodyElements and tables.

Specified by:

insertTable in interface IBody

Parameters:

pos - Position, in the bodyElements array, to insert the table

table - XWPFTable to be inserted

getTable

public XWPFTable getTable(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTbl ctTable)

if there is a corresponding XWPFTable of the parameter ctTable in the tableList of this header the method will return this table, or null if there is no corresponding XWPFTable.

Specified by:

getTable in interface IBody

getParagraph

public XWPFParagraph getParagraph(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTP p)

Description copied from interface: IBody

Returns the paragraph corresponding to the provided CTP.

Specified by:

getParagraph in interface IBody

Parameters:

p - is instance of CTP and is searching for an XWPFParagraph

Returns:

The paragraph corresponding to the CTP, or null if there is no corresponding paragraph in this body.

getParagraphArray

public XWPFParagraph getParagraphArray(int pos)

Returns the XWPFParagraph at position pos in footnote's paragraph array.

Specified by:

getParagraphArray in interface IBody

Parameters:

pos - Array position of the paragraph to get.

Returns:

the XWPFParagraph at position pos, or null if there is no paragraph at that position.

getTableCell

public XWPFTableCell getTableCell(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTc cell)

get the XWPFTableCell that belongs to the CTTc cell.

Specified by:

getTableCell in interface IBody

Returns:

XWPFTableCell that corresponds to the CTTc cell, if there is one, otherwise null.

getOwner

public POIXMLDocumentPart getOwner()

The owning object for this footnote

Returns:

The XWPFFootnotes object that contains this footnote.

insertNewTbl

public XWPFTable insertNewTbl(org.apache.xmlbeans.XmlCursor cursor)

Insert a table constructed from OOXML table markup.

Specified by:

insertNewTbl in interface IBody

Returns:

the inserted XWPFTable

insertNewParagraph

public XWPFParagraph insertNewParagraph(org.apache.xmlbeans.XmlCursor cursor)

Add a new XWPFParagraph at position of the cursor.

Specified by:

insertNewParagraph in interface IBody

Returns:

The inserted XWPFParagraph

addNewTbl

public XWPFTable addNewTbl(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTbl table)

Add a new XWPFTable to the end of the footnote.

Parameters:

table - CTTbl object from which to construct the XWPFTable

Returns:

The added XWPFTable

addNewParagraph

public XWPFParagraph addNewParagraph(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTP paragraph)

Add a new XWPFParagraph to the end of the footnote.

Parameters:

paragraph - CTP paragraph from which to construct the XWPFParagraph

Returns:

The added XWPFParagraph

getXWPFDocument

public XWPFDocument getXWPFDocument()

Get the XWPFDocument the footnote is part of.

Specified by:

getXWPFDocument in interface IBody

getPart

public POIXMLDocumentPart getPart()

Get the Part to which the footnote belongs, which you need for adding relationships to other parts

Specified by:

getPart in interface IBody

Returns:

POIXMLDocumentPart that contains the footnote.

getPartType

public BodyType getPartType()

Get the part type BodyType of the footnote.

Specified by:

getPartType in interface IBody

Returns:

The BodyType value.

getId

public BigInteger getId()

Get the ID of the footnote.

Footnote IDs are unique across all bottom-of-the-page and end note footnotes.

Returns:

Footnote ID

Since:

4.0.0

createParagraph

public XWPFParagraph createParagraph()

Appends a new XWPFParagraph to this footnote.

Returns:

The new XWPFParagraph

Since:

4.0.0

ensureFootnoteRef

public abstract void ensureFootnoteRef(XWPFParagraph p)

Ensure that the specified paragraph has a reference marker for this footnote by adding a footnote reference if one is not found.

This method is for the first paragraph in the footnote, not paragraphs that will refer to the footnote. For references to the footnote, use XWPFParagraph.addFootnoteReference(XWPFAbstractFootnoteEndnote).

The first run of the first paragraph in a footnote should contain a CTFtnEdnRef object.

Parameters:

p - The XWPFParagraph to ensure

Since:

4.0.0

createTable

public XWPFTable createTable()

Appends a new XWPFTable to this footnote

Returns:

The new XWPFTable

Since:

4.0.0

createTable

public XWPFTable createTable(int rows,
                             int cols)

Appends a new XWPFTable to this footnote

Parameters:

rows - Number of rows to initialize the table with

cols - Number of columns to initialize the table with

Returns:

the new XWPFTable with the specified number of rows and columns

Since:

4.0.0