Package org.apache.pdfbox.pdmodel.interactive.annotation

Class PDAnnotationMarkup

java.lang.Object

org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotation

org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationMarkup

All Implemented Interfaces:

COSObjectable

Direct Known Subclasses:

PDAnnotationFileAttachment, PDAnnotationLine, PDAnnotationRubberStamp, PDAnnotationSquareCircle, PDAnnotationText, PDAnnotationTextMarkup

public class PDAnnotationMarkup
extends PDAnnotation

This class represents the additional fields of a Markup type Annotation. See section 12.5.6 of ISO32000-1:2008 (starting with page 390) for details on annotation types.

Author:

Paul King

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	RT_GROUP	Constant for an annotation reply type.
static java.lang.String	RT_REPLY	Constant for an annotation reply type.
static java.lang.String	SUB_TYPE_CARET	Constant for an Caret type of annotation.
static java.lang.String	SUB_TYPE_FREETEXT	Constant for a FreeText type of annotation.
static java.lang.String	SUB_TYPE_INK	Constant for an Ink type of annotation.
static java.lang.String	SUB_TYPE_POLYGON	Constant for an Polygon type of annotation.
static java.lang.String	SUB_TYPE_POLYLINE	Constant for an PolyLine type of annotation.
static java.lang.String	SUB_TYPE_SOUND	Constant for an Sound type of annotation.

Constructor Summary

Constructors

Constructor	Description
PDAnnotationMarkup()	Constructor.
PDAnnotationMarkup(COSDictionary dict)	Constructor.

Method Summary

Modifier and Type	Method	Description
PDBorderStyleDictionary	getBorderStyle()	This will retrieve the border style dictionary, specifying the width and dash pattern used in drawing the line.
float	getConstantOpacity()	This will retrieve the constant opacity value used when rendering the annotation (excluing any popup).
java.util.Calendar	getCreationDate()	This will retrieve the date and time the annotation was created.
PDExternalDataDictionary	getExternalData()	This will return the external data dictionary.
PDAnnotation	getInReplyTo()	This will retrieve the annotation to which this one is "In Reply To" the actual relationship is specified by the RT entry.
java.lang.String	getIntent()	This will retrieve the intent of the annotation The values and meanings are specific to the actual annotation See the IT_* constants for the annotation classes.
PDAnnotationPopup	getPopup()	This will retrieve the popup annotation used for entering/editing the text for this annotation.
java.lang.String	getReplyType()	This will retrieve the Reply Type (relationship) with the annotation in the IRT entry See the RT_* constants for the available values.
java.lang.String	getRichContents()	This will retrieve the rich text stream which is displayed in the popup window.
java.lang.String	getSubject()	This will retrieve the short description of the subject of the annotation.
java.lang.String	getTitlePopup()	Retrieve the string used as the title of the popup window shown when open and active (by convention this identifies who added the annotation).
void	setBorderStyle(PDBorderStyleDictionary bs)	This will set the border style dictionary, specifying the width and dash pattern used in drawing the line.
void	setConstantOpacity(float ca)	This will set the constant opacity value used when rendering the annotation (excluing any popup).
void	setCreationDate(java.util.Calendar creationDate)	This will set the date and time the annotation was created.
void	setExternalData(PDExternalDataDictionary externalData)	This will set the external data dictionary.
void	setInReplyTo(PDAnnotation irt)	This will set the annotation to which this one is "In Reply To" the actual relationship is specified by the RT entry.
void	setIntent(java.lang.String it)	This will set the intent of the annotation The values and meanings are specific to the actual annotation See the IT_* constants for the annotation classes.
void	setPopup(PDAnnotationPopup popup)	This will set the popup annotation used for entering/editing the text for this annotation.
void	setReplyType(java.lang.String rt)	This will set the Reply Type (relationship) with the annotation in the IRT entry See the RT_* constants for the available values.
void	setRichContents(java.lang.String rc)	This will set the rich text stream which is displayed in the popup window.
void	setSubject(java.lang.String subj)	This will set the short description of the subject of the annotation.
void	setTitlePopup(java.lang.String t)	Set the string used as the title of the popup window shown when open and active (by convention this identifies who added the annotation).

Methods inherited from class java.lang.Object

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

Methods inherited from class org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotation

createAnnotation, getAnnotationFlags, getAnnotationName, getAppearance, getAppearanceState, getBorder, getColor, getColor, getContents, getCOSObject, getModifiedDate, getNormalAppearanceStream, getOptionalContent, getPage, getRectangle, getStructParent, getSubtype, isHidden, isInvisible, isLocked, isNoRotate, isNoView, isNoZoom, isPrinted, isReadOnly, isToggleNoView, setAnnotationFlags, setAnnotationName, setAppearance, setAppearanceState, setBorder, setColor, setContents, setHidden, setInvisible, setLocked, setModifiedDate, setModifiedDate, setNoRotate, setNoView, setNoZoom, setOptionalContent, setPage, setPrinted, setReadOnly, setRectangle, setStructParent, setToggleNoView

Field Detail

SUB_TYPE_FREETEXT

public static final java.lang.String SUB_TYPE_FREETEXT

Constant for a FreeText type of annotation.

See Also:

Constant Field Values

SUB_TYPE_POLYGON

public static final java.lang.String SUB_TYPE_POLYGON

Constant for an Polygon type of annotation.

See Also:

Constant Field Values

SUB_TYPE_POLYLINE

public static final java.lang.String SUB_TYPE_POLYLINE

Constant for an PolyLine type of annotation.

See Also:

Constant Field Values

SUB_TYPE_CARET

public static final java.lang.String SUB_TYPE_CARET

Constant for an Caret type of annotation.

See Also:

Constant Field Values

SUB_TYPE_INK

public static final java.lang.String SUB_TYPE_INK

Constant for an Ink type of annotation.

See Also:

Constant Field Values

SUB_TYPE_SOUND

public static final java.lang.String SUB_TYPE_SOUND

Constant for an Sound type of annotation.

See Also:

Constant Field Values

RT_REPLY

public static final java.lang.String RT_REPLY

Constant for an annotation reply type.

See Also:

Constant Field Values

RT_GROUP

public static final java.lang.String RT_GROUP

Constant for an annotation reply type.

See Also:

Constant Field Values

Constructor Detail

PDAnnotationMarkup

public PDAnnotationMarkup()

Constructor.

PDAnnotationMarkup

public PDAnnotationMarkup(COSDictionary dict)

Constructor.

Parameters:

dict - The annotations dictionary.

Method Detail

getTitlePopup

public java.lang.String getTitlePopup()

Retrieve the string used as the title of the popup window shown when open and active (by convention this identifies who added the annotation).

Returns:

The title of the popup.

setTitlePopup

public void setTitlePopup(java.lang.String t)

Set the string used as the title of the popup window shown when open and active (by convention this identifies who added the annotation).

Parameters:

t - The title of the popup.

getPopup

public PDAnnotationPopup getPopup()

This will retrieve the popup annotation used for entering/editing the text for this annotation.

Returns:

the popup annotation.

setPopup

public void setPopup(PDAnnotationPopup popup)

This will set the popup annotation used for entering/editing the text for this annotation.

Parameters:

popup - the popup annotation.

getConstantOpacity

public float getConstantOpacity()

This will retrieve the constant opacity value used when rendering the annotation (excluing any popup).

Returns:

the constant opacity value.

setConstantOpacity

public void setConstantOpacity(float ca)

This will set the constant opacity value used when rendering the annotation (excluing any popup).

Parameters:

ca - the constant opacity value.

getRichContents

public java.lang.String getRichContents()

This will retrieve the rich text stream which is displayed in the popup window.

Returns:

the rich text stream.

setRichContents

public void setRichContents(java.lang.String rc)

This will set the rich text stream which is displayed in the popup window.

Parameters:

rc - the rich text stream.

getCreationDate

public java.util.Calendar getCreationDate()
                                   throws java.io.IOException

This will retrieve the date and time the annotation was created.

Returns:

the creation date/time.

Throws:

java.io.IOException - if there is a format problem when converting the date.

setCreationDate

public void setCreationDate(java.util.Calendar creationDate)

This will set the date and time the annotation was created.

Parameters:

creationDate - the date and time the annotation was created.

getInReplyTo

public PDAnnotation getInReplyTo()
                          throws java.io.IOException

This will retrieve the annotation to which this one is "In Reply To" the actual relationship is specified by the RT entry.

Returns:

the other annotation or null if there is none.

Throws:

java.io.IOException - if there is an error creating the other annotation.

setInReplyTo

public void setInReplyTo(PDAnnotation irt)

This will set the annotation to which this one is "In Reply To" the actual relationship is specified by the RT entry.

Parameters:

irt - the annotation this one is "In Reply To".

getSubject

public java.lang.String getSubject()

This will retrieve the short description of the subject of the annotation.

Returns:

the subject.

setSubject

public void setSubject(java.lang.String subj)

This will set the short description of the subject of the annotation.

Parameters:

subj - short description of the subject.

getReplyType

public java.lang.String getReplyType()

This will retrieve the Reply Type (relationship) with the annotation in the IRT entry See the RT_* constants for the available values.

Returns:

the relationship.

setReplyType

public void setReplyType(java.lang.String rt)

This will set the Reply Type (relationship) with the annotation in the IRT entry See the RT_* constants for the available values.

Parameters:

rt - the reply type.

getIntent

public java.lang.String getIntent()

This will retrieve the intent of the annotation The values and meanings are specific to the actual annotation See the IT_* constants for the annotation classes.

Returns:

the intent

setIntent

public void setIntent(java.lang.String it)

This will set the intent of the annotation The values and meanings are specific to the actual annotation See the IT_* constants for the annotation classes.

Parameters:

it - the intent

getExternalData

public PDExternalDataDictionary getExternalData()

This will return the external data dictionary.

Returns:

the external data dictionary

setExternalData

public void setExternalData(PDExternalDataDictionary externalData)

This will set the external data dictionary.

Parameters:

externalData - the external data dictionary

setBorderStyle

public void setBorderStyle(PDBorderStyleDictionary bs)

This will set the border style dictionary, specifying the width and dash pattern used in drawing the line.

Parameters:

bs - the border style dictionary to set.

getBorderStyle

public PDBorderStyleDictionary getBorderStyle()

This will retrieve the border style dictionary, specifying the width and dash pattern used in drawing the line.

Returns:

the border style dictionary.