Package org.apache.poi.xwpf.usermodel

Class XWPFComments

java.lang.Object

org.apache.poi.ooxml.POIXMLDocumentPart

org.apache.poi.xwpf.usermodel.XWPFComments

public class XWPFComments
extends POIXMLDocumentPart

specifies all of the comments defined in the current document

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

POIXMLDocumentPart.RelationPart

Constructor Summary

Constructors

Constructor	Description
XWPFComments()	Construct XWPFComments from scratch for a new document.
XWPFComments(POIXMLDocumentPart parent, PackagePart part)	Construct XWPFComments from a package part

Method Summary

Modifier and Type	Method	Description
String	addPictureData(byte[] pictureData, int format)	Adds a picture to the comments.
String	addPictureData(byte[] pictureData, PictureType pictureType)	Adds a picture to the comments.
String	addPictureData(InputStream is, int format)	Adds a picture to the comments.
String	addPictureData(InputStream is, PictureType pictureType)	Adds a picture to the comments.
protected void	commit()	save and commit comments
XWPFComment	createComment(BigInteger cid)	Create a new comment and add it to the document.
List<XWPFPictureData>	getAllPictures()
XWPFComment	getComment(int pos)	Get the specified comment by position
XWPFComment	getComment(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTComment ctComment)	Get the specified comment by ctComment
XWPFComment	getCommentByID(String id)	Get the specified comment by comment id
List<XWPFComment>	getComments()	Get the list of XWPFComment in the Comments part.
org.openxmlformats.schemas.wordprocessingml.x2006.main.CTComments	getCtComments()	Gets the underlying CTComments object for the comments.
XWPFDocument	getXWPFDocument()
void	onDocumentRead()	read comments form an existing package
boolean	removeComment(int pos)	Remove the specified comment if present.
void	setCtComments(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTComments ctComments)	set a new comments
void	setXWPFDocument(XWPFDocument document)

Methods inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

_invokeOnDocumentRead, addRelation, createRelationship, createRelationship, createRelationship, getNextPartNumber, getPackagePart, getParent, getRelationById, getRelationId, getRelationPartById, getRelationParts, getRelations, getTargetPart, isCommitted, onDocumentCreate, onDocumentRemove, onSave, prepareForCommit, read, rebase, removeRelation, removeRelation, removeRelation, setCommitted, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

XWPFComments

public XWPFComments(POIXMLDocumentPart parent,
                    PackagePart part)

Construct XWPFComments from a package part

Parameters:

part - the package part holding the data of the footnotes,

XWPFComments

public XWPFComments()

Construct XWPFComments from scratch for a new document.

Method Detail

onDocumentRead

public void onDocumentRead()
                    throws IOException

read comments form an existing package

Overrides:

onDocumentRead in class POIXMLDocumentPart

Throws:

IOException - a subclass may throw an IOException when a document is read

addPictureData

public String addPictureData(InputStream is,
                             int format)
                      throws InvalidFormatException,
                             IOException

Adds a picture to the comments.

Parameters:

is - The stream to read image from

format - The format of the picture, see Document

Returns:

the index to this picture (0 based), the added picture can be obtained from getAllPictures() .

Throws:

InvalidFormatException - If the format of the picture is not known.

IOException - If reading the picture-data from the stream fails.

See Also:

addPictureData(InputStream, PictureType)

addPictureData

public String addPictureData(InputStream is,
                             PictureType pictureType)
                      throws InvalidFormatException,
                             IOException

Adds a picture to the comments.

Parameters:

is - The stream to read image from

pictureType - The PictureType of the picture

Returns:

the index to this picture (0 based), the added picture can be obtained from getAllPictures() .

Throws:

InvalidFormatException - If the pictureType of the picture is not known.

IOException - If reading the picture-data from the stream fails.

Since:

POI 5.2.3

addPictureData

public String addPictureData(byte[] pictureData,
                             int format)
                      throws InvalidFormatException

Adds a picture to the comments.

Parameters:

pictureData - The picture data

format - The format of the picture, see Document

Returns:

the index to this picture (0 based), the added picture can be obtained from getAllPictures() .

Throws:

InvalidFormatException - If the format of the picture is not known.

addPictureData

public String addPictureData(byte[] pictureData,
                             PictureType pictureType)
                      throws InvalidFormatException

Adds a picture to the comments.

Parameters:

pictureData - The picture data

pictureType - The PictureType of the picture.

Returns:

the index to this picture (0 based), the added picture can be obtained from getAllPictures() .

Throws:

InvalidFormatException - If the pictureType of the picture is not known.

Since:

POI 5.2.3

commit

protected void commit()
               throws IOException

save and commit comments

Overrides:

commit in class POIXMLDocumentPart

Throws:

IOException - a subclass may throw an IOException if the changes can't be committed

getAllPictures

public List<XWPFPictureData> getAllPictures()

getCtComments

public org.openxmlformats.schemas.wordprocessingml.x2006.main.CTComments getCtComments()

Gets the underlying CTComments object for the comments.

Returns:

CTComments object

setCtComments

@Internal
public void setCtComments(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTComments ctComments)

set a new comments

getComments

public List<XWPFComment> getComments()

Get the list of XWPFComment in the Comments part.

getComment

public XWPFComment getComment(int pos)

Get the specified comment by position

Parameters:

pos - Array position of the comment

getCommentByID

public XWPFComment getCommentByID(String id)

Get the specified comment by comment id

Parameters:

id - comment id

Returns:

the specified comment

getComment

public XWPFComment getComment(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTComment ctComment)

Get the specified comment by ctComment

createComment

public XWPFComment createComment(BigInteger cid)

Create a new comment and add it to the document.

Parameters:

cid - comment Id

removeComment

public boolean removeComment(int pos)

Remove the specified comment if present.

Parameters:

pos - Array position of the comment to be removed

Returns:

True if the comment was removed.

getXWPFDocument

public XWPFDocument getXWPFDocument()

setXWPFDocument

public void setXWPFDocument(XWPFDocument document)