PdfAnnotation (iText 7 7.0.4 API)

java.lang.Object
- com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfDictionary>
- - com.itextpdf.kernel.pdf.annot.PdfAnnotation

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

Pdf3DAnnotation, PdfLinkAnnotation, PdfMarkupAnnotation, PdfPopupAnnotation, PdfPrinterMarkAnnotation, PdfRichMediaAnnotation, PdfScreenAnnotation, PdfTrapNetworkAnnotation, PdfWatermarkAnnotation, PdfWidgetAnnotation
```
public abstract class PdfAnnotation
extends PdfObjectWrapper<PdfDictionary>
```
This is a super class for the annotation dictionary wrappers. Derived classes represent different standard types of annotations. See ISO-320001 12.5.6, “Annotation Types.”

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static PdfString`	`Accepted` Annotation state.
`static PdfString`	`Canceled` Annotation state.
`static PdfString`	`Completed` Annotation state.
`static int`	`HIDDEN` Annotation flag.
`static PdfName`	`HIGHLIGHT_INVERT` Widget annotation highlighting mode.
`static PdfName`	`HIGHLIGHT_NONE` Widget annotation highlighting mode.
`static PdfName`	`HIGHLIGHT_OUTLINE` Widget annotation highlighting mode.
`static PdfName`	`HIGHLIGHT_PUSH` Widget annotation highlighting mode.
`static PdfName`	`HIGHLIGHT_TOGGLE` Widget annotation highlighting mode.
`static int`	`INVISIBLE` Annotation flag.
`static int`	`LOCKED` Annotation flag.
`static int`	`LOCKED_CONTENTS` Annotation flag.
`static PdfString`	`Marked` Annotation state.
`static PdfString`	`MarkedModel` Annotation state model.
`static int`	`NO_ROTATE` Annotation flag.
`static int`	`NO_VIEW` Annotation flag.
`static int`	`NO_ZOOM` Annotation flag.
`static PdfString`	`None` Annotation state.
`protected PdfPage`	`page`
`static int`	`PRINT` Annotation flag.
`static int`	`READ_ONLY` Annotation flag.
`static PdfString`	`Rejected` Annotation state.
`static PdfString`	`ReviewModel` Annotation state model.
`static PdfName`	`STYLE_BEVELED` Annotation border style.
`static PdfName`	`STYLE_DASHED` Annotation border style.
`static PdfName`	`STYLE_INSET` Annotation border style.
`static PdfName`	`STYLE_SOLID` Annotation border style.
`static PdfName`	`STYLE_UNDERLINE` Annotation border style.
`static int`	`TOGGLE_NO_VIEW` Annotation flag.
`static PdfString`	`Unmarked` Annotation state.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`PdfAnnotation(PdfDictionary pdfObject)`
`protected`	`PdfAnnotation(Rectangle rect)`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`flush()` To manually flush a `PdfObject` behind this wrapper, you have to ensure that this object is added to the document, i.e.
`PdfDictionary`	`getAction()` An `PdfAction` to perform, such as launching an application, playing a sound, changing an annotation’s appearance state etc, when the annotation is activated.
`PdfDictionary`	`getAdditionalAction()` An additional actions dictionary that extends the set of events that can trigger the execution of an action.
`PdfDictionary`	`getAppearanceCharacteristics()` An appearance characteristics dictionary containing additional information for constructing the annotation’s appearance stream.
`PdfDictionary`	`getAppearanceDictionary()` An appearance dictionary specifying how the annotation shall be presented visually on the page during its interactions with the user (see ISO-320001 12.5.5, “Appearance Streams”).
`PdfDictionary`	`getAppearanceObject(PdfName appearanceType)` Specific appearance object corresponding to the specific appearance type.
`PdfName`	`getAppearanceState()` The annotation’s appearance state, which selects the applicable appearance stream from an appearance subdictionary if there is such.
`PdfArray`	`getBorder()` An array specifying the characteristics of the annotation’s border.
`PdfDictionary`	`getBorderStyle()` The dictionaries for some annotation types (such as free text and polygon annotations) can include the BS entry.
`PdfArray`	`getColorObject()` An array of numbers in the range 0.0 to 1.0, representing a colour used for the following purposes: The background of the annotation’s icon when closed The title bar of the annotation’s pop-up window The border of a link annotation The number of array elements determines the colour space in which the colour shall be defined: 0 - No colour; transparent 1 - DeviceGray 3 - DeviceRGB 4 - DeviceCMYK
`PdfString`	`getContents()` Gets the text that shall be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form.
`PdfString`	`getDate()` The date and time when the annotation was most recently modified.
`PdfDictionary`	`getDownAppearanceObject()` The down appearance is used when the mouse button is pressed or held down within the annotation’s active area.
`int`	`getFlags()` A set of flags specifying various characteristics of the annotation (see ISO-320001 12.5.3, “Annotation Flags”).
`PdfString`	`getName()` Gets the annotation name, a text string uniquely identifying it among all the annotations on its page.
`PdfDictionary`	`getNormalAppearanceObject()` The normal appearance is used when the annotation is not interacting with the user.
`boolean`	`getOpen()` A flag specifying whether the annotation shall initially be displayed open.
`PdfPage`	`getPage()` Gets a `PdfPage` on which annotation is placed.
`PdfDictionary`	`getPageObject()` Gets a `PdfDictionary` that represents a page of the document on which annotation is placed, i.e.
`PdfArray`	`getQuadPoints()` An array of 8 × n numbers specifying the coordinates of n quadrilaterals in default user space.
`PdfArray`	`getRectangle()` The annotation rectangle, defining the location of the annotation on the page in default user space units.
`PdfDictionary`	`getRolloverAppearanceObject()` The rollover appearance is used when the user moves the cursor into the annotation’s active area without pressing the mouse button.
`int`	`getStructParentIndex()` The integer key of the annotation’s entry in the structural parent tree (see ISO-320001 14.7.4.4, “Finding Structure Elements from Content Items”).
`abstract PdfName`	`getSubtype()` Gets a `PdfName` which value is a subtype of this annotation.
`PdfString`	`getTitle()` Annotation title.
`boolean`	`hasFlag(int flag)` Checks if the certain flag that specifies a characteristic of the annotation is in enabled state (see ISO-320001 12.5.3, “Annotation Flags”).
`protected boolean`	`isWrappedObjectMustBeIndirect()` Defines if the object behind this wrapper must be an indirect object in the resultant document.
`static PdfAnnotation`	`makeAnnotation(PdfObject pdfObject)` Factory method that creates the type specific `PdfAnnotation` from the given `PdfObject` that represents annotation object.
`static PdfAnnotation`	`makeAnnotation(PdfObject pdfObject, PdfAnnotation parent)` Deprecated. This method will be removed in iText 7.1. Please, simply use `makeAnnotation(PdfObject)`.
`PdfAnnotation`	`put(PdfName key, PdfObject value)` Inserts the value into into the underlying `PdfDictionary` of this `PdfAnnotation` and associates it with the specified key.
`PdfAnnotation`	`remove(PdfName key)` Removes the specified key from the underlying `PdfDictionary` of this `PdfAnnotation`.
`PdfAnnotation`	`resetFlag(int flag)` Resets a flag that specifies a characteristic of the annotation to disabled state (see ISO-320001 12.5.3, “Annotation Flags”).
`PdfAnnotation`	`setAction(PdfAction action)` Sets a `PdfAction` to this annotation which will be performed when the annotation is activated.
`PdfAnnotation`	`setAdditionalAction(PdfName key, PdfAction action)` Sets an additional `PdfAction` to this annotation which will be performed in response to the specific trigger event defined by `key`.
`PdfAnnotation`	`setAppearance(PdfName appearanceType, PdfAnnotationAppearance appearance)` Sets a specific type of the appearance using `PdfAnnotationAppearance` wrapper.
`PdfAnnotation`	`setAppearance(PdfName appearanceType, PdfDictionary appearance)` Sets a specific type of the appearance.
`PdfAnnotation`	`setAppearanceCharacteristics(PdfDictionary characteristics)` Sets an appearance characteristics dictionary containing additional information for constructing the annotation’s appearance stream.
`PdfAnnotation`	`setAppearanceState(PdfName as)` Sets the annotation’s appearance state, which selects the applicable appearance stream from an appearance subdictionary.
`PdfAnnotation`	`setBorder(PdfArray border)` Sets the characteristics of the annotation’s border.
`PdfAnnotation`	`setBorderStyle(PdfDictionary borderStyle)` Sets border style dictionary that has more settings than the array specified for the Border entry (`getBorder()`).
`PdfAnnotation`	`setBorderStyle(PdfName style)` Setter for the annotation's preset border style.
`PdfAnnotation`	`setColor(Color color)` Sets an annotation color.
`PdfAnnotation`	`setColor(float[] color)` Sets an annotation color.
`PdfAnnotation`	`setColor(PdfArray color)` Sets an annotation color.
`PdfAnnotation`	`setContents(PdfString contents)` Sets the text that shall be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form.
`PdfAnnotation`	`setContents(String contents)` Sets the text that shall be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form.
`PdfAnnotation`	`setDashPattern(PdfArray dashPattern)` Setter for the annotation's preset dashed border style.
`PdfAnnotation`	`setDate(PdfString date)` The date and time when the annotation was most recently modified.
`PdfAnnotation`	`setDownAppearance(PdfAnnotationAppearance appearance)` Sets down appearance using `PdfAnnotationAppearance` wrapper.
`PdfAnnotation`	`setDownAppearance(PdfDictionary appearance)` Sets down appearance.
`PdfAnnotation`	`setFlag(int flag)` Sets a flag that specifies a characteristic of the annotation to enabled state (see ISO-320001 12.5.3, “Annotation Flags”).
`PdfAnnotation`	`setFlags(int flags)` Sets a set of flags specifying various characteristics of the annotation (see ISO-320001 12.5.3, “Annotation Flags”).
`void`	`setLayer(IPdfOCG layer)` Sets the layer this annotation belongs to.
`PdfAnnotation`	`setName(PdfString name)` Sets the annotation name, a text string uniquely identifying it among all the annotations on its page.
`PdfAnnotation`	`setNormalAppearance(PdfAnnotationAppearance appearance)` Sets normal appearance using `PdfAnnotationAppearance` wrapper.
`PdfAnnotation`	`setNormalAppearance(PdfDictionary appearance)` Sets normal appearance.
`PdfAnnotation`	`setOpen(boolean open)` Sets a flag specifying whether the annotation shall initially be displayed open.
`PdfAnnotation`	`setPage(PdfPage page)` Method that modifies annotation page property, which defines to which page annotation belongs.
`PdfAnnotation`	`setQuadPoints(PdfArray quadPoints)` Sets n quadrilaterals in default user space by passing an `PdfArray` of 8 × n numbers.
`PdfAnnotation`	`setRectangle(PdfArray array)` The annotation rectangle, defining the location of the annotation on the page in default user space units.
`PdfAnnotation`	`setRolloverAppearance(PdfAnnotationAppearance appearance)` Sets rollover appearance using `PdfAnnotationAppearance` wrapper.
`PdfAnnotation`	`setRolloverAppearance(PdfDictionary appearance)` Sets rollover appearance.
`PdfAnnotation`	`setStructParentIndex(int structParentIndex)` Sets he integer key of the annotation’s entry in the structural parent tree (see ISO-320001 14.7.4.4, “Finding Structure Elements from Content Items”).
`PdfAnnotation`	`setTitle(PdfString title)` Sets annotation title.

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper
ensureObjectIsAddedToDocument, ensureUnderlyingObjectHasIndirectReference, getPdfObject, isFlushed, makeIndirect, makeIndirect, markObjectAsIndirect, setForbidRelease, setModified, setPdfObject, unsetForbidRelease

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - INVISIBLE
```
public static final int INVISIBLE
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - HIDDEN
```
public static final int HIDDEN
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - PRINT
```
public static final int PRINT
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - NO_ZOOM
```
public static final int NO_ZOOM
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - NO_ROTATE
```
public static final int NO_ROTATE
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - NO_VIEW
```
public static final int NO_VIEW
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - READ_ONLY
```
public static final int READ_ONLY
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - LOCKED
```
public static final int LOCKED
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - TOGGLE_NO_VIEW
```
public static final int TOGGLE_NO_VIEW
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - LOCKED_CONTENTS
```
public static final int LOCKED_CONTENTS
```
    Annotation flag. See also setFlag(int) and ISO-320001, table 165.
    
    See Also:
    
    Constant Field Values
  - HIGHLIGHT_NONE
```
public static final PdfName HIGHLIGHT_NONE
```
    Widget annotation highlighting mode. See ISO-320001, Table 188 (H key). Also see PdfWidgetAnnotation.setHighlightMode(PdfName).
  - HIGHLIGHT_INVERT
```
public static final PdfName HIGHLIGHT_INVERT
```
    Widget annotation highlighting mode. See ISO-320001, Table 188 (H key). Also see PdfWidgetAnnotation.setHighlightMode(PdfName).
  - HIGHLIGHT_OUTLINE
```
public static final PdfName HIGHLIGHT_OUTLINE
```
    Widget annotation highlighting mode. See ISO-320001, Table 188 (H key). Also see PdfWidgetAnnotation.setHighlightMode(PdfName).
  - HIGHLIGHT_PUSH
```
public static final PdfName HIGHLIGHT_PUSH
```
    Widget annotation highlighting mode. See ISO-320001, Table 188 (H key). Also see PdfWidgetAnnotation.setHighlightMode(PdfName).
  - HIGHLIGHT_TOGGLE
```
public static final PdfName HIGHLIGHT_TOGGLE
```
    Widget annotation highlighting mode. See ISO-320001, Table 188 (H key). Also see PdfWidgetAnnotation.setHighlightMode(PdfName).
  - STYLE_SOLID
```
public static final PdfName STYLE_SOLID
```
    Annotation border style. See ISO-320001, Table 166 (S key). Also see setBorderStyle(PdfName)
  - STYLE_DASHED
```
public static final PdfName STYLE_DASHED
```
    Annotation border style. See ISO-320001, Table 166 (S key). Also see setBorderStyle(PdfName)
  - STYLE_BEVELED
```
public static final PdfName STYLE_BEVELED
```
    Annotation border style. See ISO-320001, Table 166 (S key). Also see setBorderStyle(PdfName)
  - STYLE_INSET
```
public static final PdfName STYLE_INSET
```
    Annotation border style. See ISO-320001, Table 166 (S key). Also see setBorderStyle(PdfName)
  - STYLE_UNDERLINE
```
public static final PdfName STYLE_UNDERLINE
```
    Annotation border style. See ISO-320001, Table 166 (S key). Also see setBorderStyle(PdfName)
  - Marked
```
public static final PdfString Marked
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - Unmarked
```
public static final PdfString Unmarked
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - Accepted
```
public static final PdfString Accepted
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - Rejected
```
public static final PdfString Rejected
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - Canceled
```
public static final PdfString Canceled
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - Completed
```
public static final PdfString Completed
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - None
```
public static final PdfString None
```
    Annotation state. See ISO-320001 12.5.6.3 "Annotation States" and Table 171 in particular. Also see PdfTextAnnotation.setState(PdfString).
  - MarkedModel
```
public static final PdfString MarkedModel
```
    Annotation state model. See ISO-320001, Table 172 (StateModel key). Also see PdfTextAnnotation.setStateModel(PdfString).
  - ReviewModel
```
public static final PdfString ReviewModel
```
    Annotation state model. See ISO-320001, Table 172 (StateModel key). Also see PdfTextAnnotation.setStateModel(PdfString).
  - page
```
protected PdfPage page
```
- Constructor Detail
  - PdfAnnotation
```
protected PdfAnnotation(Rectangle rect)
```
  - PdfAnnotation
```
protected PdfAnnotation(PdfDictionary pdfObject)
```
- Method Detail
  - makeAnnotation
```
public static PdfAnnotation makeAnnotation(PdfObject pdfObject)
```
    Factory method that creates the type specific PdfAnnotation from the given PdfObject that represents annotation object. This method is useful for property reading in reading mode or modifying in stamping mode. See derived classes of this class to see possible specific annotation types created.
    
    Parameters:
    
    pdfObject - a PdfObject that represents annotation in the document.
    
    Returns:
    
    created PdfAnnotation.
  - makeAnnotation
```
@Deprecated
public static PdfAnnotation makeAnnotation(PdfObject pdfObject,
                                                       PdfAnnotation parent)
```
    Deprecated. This method will be removed in iText 7.1. Please, simply use makeAnnotation(PdfObject).
    
    Factory method that creates the type specific PdfAnnotation from the given PdfObject that represents annotation object. This method is useful for property reading in reading mode or modifying in stamping mode.
    
    Parameters:
    
    pdfObject - a PdfObject that represents annotation in the document.
    
    parent - parent annotation of the PdfPopupAnnotation to be created. This parameter is only needed if passed PdfObject represents a pop-up annotation in the document.
    
    Returns:
    
    created PdfAnnotation.
  - getSubtype
```
public abstract PdfName getSubtype()
```
    Gets a PdfName which value is a subtype of this annotation. See ISO-320001 12.5.6, “Annotation Types” for the reference to the possible types.
    
    Returns:
    
    subtype of this annotation.
  - setLayer
```
public void setLayer(IPdfOCG layer)
```
    Sets the layer this annotation belongs to.
    
    Parameters:
    
    layer - the layer this annotation belongs to
  - setAction
```
public PdfAnnotation setAction(PdfAction action)
```
    Sets a PdfAction to this annotation which will be performed when the annotation is activated.
    
    Parameters:
    
    action - PdfAction to set to this annotation.
    
    Returns:
    
    this PdfAnnotation instance.
  - setAdditionalAction
```
public PdfAnnotation setAdditionalAction(PdfName key,
                                         PdfAction action)
```
    Sets an additional PdfAction to this annotation which will be performed in response to the specific trigger event defined by key. See ISO-320001 12.6.3, "Trigger Events".
    
    Parameters:
    
    key - a PdfName that denotes a type of the additional action to set.
    
    action - PdfAction to set as additional to this annotation.
    
    Returns:
    
    this PdfAnnotation instance.
  - getContents
```
public PdfString getContents()
```
    Gets the text that shall be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form.
    
    Returns:
    
    annotation text content.
  - setContents
```
public PdfAnnotation setContents(PdfString contents)
```
    Sets the text that shall be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form.
    
    Parameters:
    
    contents - a PdfString containing text content to be set to the annotation.
    
    Returns:
    
    this PdfAnnotation instance.
  - setContents
```
public PdfAnnotation setContents(String contents)
```
    Sets the text that shall be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form.
    
    Parameters:
    
    contents - a java String containing text content to be set to the annotation.
    
    Returns:
    
    this PdfAnnotation instance.
  - getPageObject
```
public PdfDictionary getPageObject()
```
    Gets a PdfDictionary that represents a page of the document on which annotation is placed, i.e. which has this annotation in it's /Annots array.
    
    Returns:
    
    PdfDictionary that is a page pdf object or null if annotation is not added to the page yet.
  - getPage
```
public PdfPage getPage()
```
    Gets a PdfPage on which annotation is placed.
    
    Returns:
    
    PdfPage on which annotation is placed or null if annotation is not placed yet.
  - setPage
```
public PdfAnnotation setPage(PdfPage page)
```
    Method that modifies annotation page property, which defines to which page annotation belongs. Keep in mind that this doesn't actually add an annotation to the page, it should be done via PdfPage.addAnnotation(PdfAnnotation). Also you don't need to set this property manually, this is done automatically on addition to the page.
    
    Parameters:
    
    page - the PdfPage to which annotation will be added.
    
    Returns:
    
    this PdfAnnotation instance.
  - getName
```
public PdfString getName()
```
    Gets the annotation name, a text string uniquely identifying it among all the annotations on its page.
    
    Returns:
    
    a PdfString with annotation name as it's value or null if name is not specified.
  - setName
```
public PdfAnnotation setName(PdfString name)
```
    Sets the annotation name, a text string uniquely identifying it among all the annotations on its page.
    
    Parameters:
    
    name - a PdfString to be set as annotation name.
    
    Returns:
    
    this PdfAnnotation instance.
  - getDate
```
public PdfString getDate()
```
    The date and time when the annotation was most recently modified. This is an optional property of the annotation.
    
    Returns:
    
    a PdfString with the modification date as it's value or null if date is not specified.
  - setDate
```
public PdfAnnotation setDate(PdfString date)
```
    The date and time when the annotation was most recently modified.
    
    Parameters:
    
    date - a PdfString with date. The format should be a date string as described in ISO-320001 7.9.4, “Dates”.
    
    Returns:
    
    this PdfAnnotation instance.
  - getFlags
```
public int getFlags()
```
    A set of flags specifying various characteristics of the annotation (see ISO-320001 12.5.3, “Annotation Flags”). For specific annotation flag constants see setFlag(int). Default value: 0.
    
    Returns:
    
    an integer interpreted as one-bit flags specifying various characteristics of the annotation.
  - setFlags
```
public PdfAnnotation setFlags(int flags)
```
    Sets a set of flags specifying various characteristics of the annotation (see ISO-320001 12.5.3, “Annotation Flags”). On the contrary from setFlag(int), this method sets a complete set of enabled and disabled flags at once. If not set specifically the default value is 0.
    
    Parameters:
    
    flags - an integer interpreted as set of one-bit flags specifying various characteristics of the annotation.
    
    Returns:
    
    this PdfAnnotation instance.
  - setFlag
```
public PdfAnnotation setFlag(int flag)
```
    Sets a flag that specifies a characteristic of the annotation to enabled state (see ISO-320001 12.5.3, “Annotation Flags”). On the contrary from setFlags(int), this method sets only specified flags to enabled state, but doesn't disable other flags. Possible flags:
    - INVISIBLE - If set, do not display the annotation if it does not belong to one of the standard annotation types and no annotation handler is available. If clear, display such unknown annotation using an appearance stream specified by its appearance dictionary, if any.
    - HIDDEN - If set, do not display or print the annotation or allow it to interact with the user, regardless of its annotation type or whether an annotation handler is available.
    - PRINT - If set, print the annotation when the page is printed. If clear, never print the annotation, regardless of whether it is displayed on the screen.
    - NO_ZOOM - If set, do not scale the annotation’s appearance to match the magnification of the page. The location of the annotation on the page (defined by the upper-left corner of its annotation rectangle) shall remain fixed, regardless of the page magnification.}
    - NO_ROTATE - If set, do not rotate the annotation’s appearance to match the rotation of the page. The upper-left corner of the annotation rectangle shall remain in a fixed location on the page, regardless of the page rotation.
    - NO_VIEW - If set, do not display the annotation on the screen or allow it to interact with the user. The annotation may be printed (depending on the setting of the Print flag) but should be considered hidden for purposes of on-screen display and user interaction.
    - READ_ONLY - If set, do not allow the annotation to interact with the user. The annotation may be displayed or printed (depending on the settings of the NoView and Print flags) but should not respond to mouse clicks or change its appearance in response to mouse motions.
    - LOCKED - If set, do not allow the annotation to be deleted or its properties (including position and size) to be modified by the user. However, this flag does not restrict changes to the annotation’s contents, such as the value of a form field.
    - TOGGLE_NO_VIEW - If set, invert the interpretation of the NoView flag for certain events.
    - LOCKED_CONTENTS - If set, do not allow the contents of the annotation to be modified by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties, such as position and size.
    Parameters:
    
    flag - - an integer interpreted as set of one-bit flags which will be enabled for this annotation.
    
    Returns:
    
    this PdfAnnotation instance.
  - resetFlag
```
public PdfAnnotation resetFlag(int flag)
```
    Resets a flag that specifies a characteristic of the annotation to disabled state (see ISO-320001 12.5.3, “Annotation Flags”).
    
    Parameters:
    
    flag - an integer interpreted as set of one-bit flags which will be reset to disabled state.
    
    Returns:
    
    this PdfAnnotation instance.
  - hasFlag
```
public boolean hasFlag(int flag)
```
    Checks if the certain flag that specifies a characteristic of the annotation is in enabled state (see ISO-320001 12.5.3, “Annotation Flags”). This method allows only one flag to be checked at once, use constants listed in setFlag(int).
    
    Parameters:
    
    flag - an integer interpreted as set of one-bit flags. Only one bit must be set in this integer, otherwise exception is thrown.
    
    Returns:
    
    true if the given flag is in enabled state.
  - getAppearanceDictionary
```
public PdfDictionary getAppearanceDictionary()
```
    An appearance dictionary specifying how the annotation shall be presented visually on the page during its interactions with the user (see ISO-320001 12.5.5, “Appearance Streams”). An appearance dictionary is a dictionary containing one or several appearance streams or subdictionaries.
    
    Returns:
    
    an appearance PdfDictionary or null if it is not specified.
  - getAppearanceObject
```
public PdfDictionary getAppearanceObject(PdfName appearanceType)
```
    Specific appearance object corresponding to the specific appearance type. This object might be either an appearance stream or an appearance subdictionary. In the latter case, the subdictionary defines multiple appearance streams corresponding to different appearance states of the annotation. See ISO-320001 12.5.5, “Appearance Streams”.
    
    Parameters:
    
    appearanceType - a PdfName specifying appearance type. Possible types are Normal, Rollover and Down.
    
    Returns:
    
    null if their is no such appearance type or an appearance object which might be either an appearance stream or an appearance subdictionary.
  - getNormalAppearanceObject
```
public PdfDictionary getNormalAppearanceObject()
```
    The normal appearance is used when the annotation is not interacting with the user. This appearance is also used for printing the annotation. See also getAppearanceObject(PdfName).
    
    Returns:
    
    an appearance object which might be either an appearance stream or an appearance subdictionary.
  - getRolloverAppearanceObject
```
public PdfDictionary getRolloverAppearanceObject()
```
    The rollover appearance is used when the user moves the cursor into the annotation’s active area without pressing the mouse button. If not specified normal appearance is used. See also getAppearanceObject(PdfName).
    
    Returns:
    
    null if rollover appearance is not specified or an appearance object which might be either an appearance stream or an appearance subdictionary.
  - getDownAppearanceObject
```
public PdfDictionary getDownAppearanceObject()
```
    The down appearance is used when the mouse button is pressed or held down within the annotation’s active area. If not specified normal appearance is used. See also getAppearanceObject(PdfName).
    
    Returns:
    
    null if down appearance is not specified or an appearance object which might be either an appearance stream or an appearance subdictionary.
  - setAppearance
```
public PdfAnnotation setAppearance(PdfName appearanceType,
                                   PdfDictionary appearance)
```
    Sets a specific type of the appearance. See getAppearanceObject(PdfName) and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearanceType - a PdfName specifying appearance type. Possible types are Normal, Rollover and Down.
    
    appearance - an appearance object which might be either an appearance stream or an appearance subdictionary.
    
    Returns:
    
    this PdfAnnotation instance.
  - setNormalAppearance
```
public PdfAnnotation setNormalAppearance(PdfDictionary appearance)
```
    Sets normal appearance. See getNormalAppearanceObject() and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearance - an appearance object which might be either an appearance stream or an appearance subdictionary.
    
    Returns:
    
    this PdfAnnotation instance.
  - setRolloverAppearance
```
public PdfAnnotation setRolloverAppearance(PdfDictionary appearance)
```
    Sets rollover appearance. See getRolloverAppearanceObject() and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearance - an appearance object which might be either an appearance stream or an appearance subdictionary.
    
    Returns:
    
    this PdfAnnotation instance.
  - setDownAppearance
```
public PdfAnnotation setDownAppearance(PdfDictionary appearance)
```
    Sets down appearance. See getDownAppearanceObject() and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearance - an appearance object which might be either an appearance stream or an appearance subdictionary.
    
    Returns:
    
    this PdfAnnotation instance.
  - setAppearance
```
public PdfAnnotation setAppearance(PdfName appearanceType,
                                   PdfAnnotationAppearance appearance)
```
    Sets a specific type of the appearance using PdfAnnotationAppearance wrapper. This method is used to set only an appearance subdictionary. See getAppearanceObject(PdfName) and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearanceType - a PdfName specifying appearance type. Possible types are Normal, Rollover and Down.
    
    appearance - an appearance subdictionary wrapped in PdfAnnotationAppearance.
    
    Returns:
    
    this PdfAnnotation instance.
  - setNormalAppearance
```
public PdfAnnotation setNormalAppearance(PdfAnnotationAppearance appearance)
```
    Sets normal appearance using PdfAnnotationAppearance wrapper. This method is used to set only appearance subdictionary. See getNormalAppearanceObject() and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearance - an appearance subdictionary wrapped in PdfAnnotationAppearance.
    
    Returns:
    
    this PdfAnnotation instance.
  - setRolloverAppearance
```
public PdfAnnotation setRolloverAppearance(PdfAnnotationAppearance appearance)
```
    Sets rollover appearance using PdfAnnotationAppearance wrapper. This method is used to set only appearance subdictionary. See getRolloverAppearanceObject() and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearance - an appearance subdictionary wrapped in PdfAnnotationAppearance.
    
    Returns:
    
    this PdfAnnotation instance.
  - setDownAppearance
```
public PdfAnnotation setDownAppearance(PdfAnnotationAppearance appearance)
```
    Sets down appearance using PdfAnnotationAppearance wrapper. This method is used to set only appearance subdictionary. See getDownAppearanceObject() and getAppearanceDictionary() for more info.
    
    Parameters:
    
    appearance - an appearance subdictionary wrapped in PdfAnnotationAppearance.
    
    Returns:
    
    this PdfAnnotation instance.
  - getAppearanceState
```
public PdfName getAppearanceState()
```
    The annotation’s appearance state, which selects the applicable appearance stream from an appearance subdictionary if there is such. See getAppearanceObject(PdfName) for more info.
    
    Returns:
    
    a PdfName which defines selected appearance state.
  - setAppearanceState
```
public PdfAnnotation setAppearanceState(PdfName as)
```
    Sets the annotation’s appearance state, which selects the applicable appearance stream from an appearance subdictionary. See getAppearanceObject(PdfName) for more info.
    
    Parameters:
    
    as - a PdfName which defines appearance state to be selected.
    
    Returns:
    
    this PdfAnnotation instance.
  - getBorder
```
public PdfArray getBorder()
```
    An array specifying the characteristics of the annotation’s border. The array consists of three numbers defining the horizontal corner radius, vertical corner radius, and border width, all in default user space units. If the corner radii are 0, the border has square (not rounded) corners; if the border width is 0, no border is drawn.
    
    The array may have a fourth element, an optional dash array (see ISO-320001 8.4.3.6, “Line Dash Pattern”).
    
    Returns:
    
    an PdfArray specifying the characteristics of the annotation’s border.
  - setBorder
```
public PdfAnnotation setBorder(PdfArray border)
```
    Sets the characteristics of the annotation’s border.
    
    Parameters:
    
    border - an PdfArray specifying the characteristics of the annotation’s border. See getBorder() for more detailes.
    
    Returns:
    
    this PdfAnnotation instance.
  - getColorObject
```
public PdfArray getColorObject()
```
    An array of numbers in the range 0.0 to 1.0, representing a colour used for the following purposes:
    - The background of the annotation’s icon when closed
    - The title bar of the annotation’s pop-up window
    - The border of a link annotation
    The number of array elements determines the colour space in which the colour shall be defined:
    - 0 - No colour; transparent
    - 1 - DeviceGray
    - 3 - DeviceRGB
    - 4 - DeviceCMYK
    Returns:
    
    An array of numbers in the range 0.0 to 1.0, representing an annotation colour.
  - setColor
```
public PdfAnnotation setColor(PdfArray color)
```
    Sets an annotation color. For more details on annotation color purposes and the format of the passing PdfArray see getColorObject().
    
    Parameters:
    
    color - an array of numbers in the range 0.0 to 1.0, specifying color.
    
    Returns:
    
    this PdfAnnotation instance.
  - setColor
```
public PdfAnnotation setColor(float[] color)
```
    Sets an annotation color. For more details on annotation color purposes and the format of the passing array see getColorObject().
    
    Parameters:
    
    color - an array of numbers in the range 0.0 to 1.0, specifying color.
    
    Returns:
    
    this PdfAnnotation instance.
  - setColor
```
public PdfAnnotation setColor(Color color)
```
    Sets an annotation color. For more details on annotation color purposes see getColorObject().
    
    Parameters:
    
    color - Color object of the either DeviceGray, DeviceRgb or DeviceCmyk type.
    
    Returns:
    
    this PdfAnnotation instance.
  - getStructParentIndex
```
public int getStructParentIndex()
```
    The integer key of the annotation’s entry in the structural parent tree (see ISO-320001 14.7.4.4, “Finding Structure Elements from Content Items”).
    
    Returns:
    
    integer key in structural parent tree or -1 if annotation is not tagged.
  - setStructParentIndex
```
public PdfAnnotation setStructParentIndex(int structParentIndex)
```
    Sets he integer key of the annotation’s entry in the structural parent tree (see ISO-320001 14.7.4.4, “Finding Structure Elements from Content Items”). Note: Normally, there is no need to take care of this manually, struct parent index is set automatically if annotation is added to the tagged document's page.
    
    Parameters:
    
    structParentIndex - integer which is to be the key of the annotation's entry in structural parent tree.
    
    Returns:
    
    this PdfAnnotation instance.
  - getOpen
```
public boolean getOpen()
```
    A flag specifying whether the annotation shall initially be displayed open. This flag has affect to not all kinds of annotations.
    
    Returns:
    
    true if annotation is initially open, false - if closed.
  - setOpen
```
public PdfAnnotation setOpen(boolean open)
```
    Sets a flag specifying whether the annotation shall initially be displayed open. This flag has affect to not all kinds of annotations.
    
    Parameters:
    
    open - true if annotation shall initially be open, false - if closed.
    
    Returns:
    
    this PdfAnnotation instance.
  - getQuadPoints
```
public PdfArray getQuadPoints()
```
    An array of 8 × n numbers specifying the coordinates of n quadrilaterals in default user space. Quadrilaterals are used to define:
    - regions inside annotation rectangle in which the link annotation should be activated;
    - a word or group of contiguous words in the text underlying the text markup annotation;
    - the content region that is intended to be removed for a redaction annotation;
    IMPORTANT NOTE: According to Table 179 in ISO 32000-1, the QuadPoints array lists the vertices in counterclockwise order and the text orientation is defined by the first and second vertex. This basically means QuadPoints is specified as lower-left, lower-right, top-right, top-left. HOWEVER, Adobe's interpretation (tested at least with Acrobat 10, Acrobat 11, Reader 11) is top-left, top-right, lower-left, lower-right (Z-shaped order). This means that if the QuadPoints array is specified according to the standard, the rendering is not as expected. Other viewers seem to follow Adobe's interpretation. Hence we recommend to use and expect QuadPoints array in Z-order, just as Acrobat and probably most other viewers expect.
    Returns:
    
    an PdfArray of 8 × n numbers specifying the coordinates of n quadrilaterals.
  - setQuadPoints
```
public PdfAnnotation setQuadPoints(PdfArray quadPoints)
```
    Sets n quadrilaterals in default user space by passing an PdfArray of 8 × n numbers. For more info of what quadrilaterals define see getQuadPoints().
    IMPORTANT NOTE: According to Table 179 in ISO 32000-1, the QuadPoints array lists the vertices in counterclockwise order and the text orientation is defined by the first and second vertex. This basically means QuadPoints is specified as lower-left, lower-right, top-right, top-left. HOWEVER, Adobe's interpretation (tested at least with Acrobat 10, Acrobat 11, Reader 11) is top-left, top-right, lower-left, lower-right (Z-shaped order). This means that if the QuadPoints array is specified according to the standard, the rendering is not as expected. Other viewers seem to follow Adobe's interpretation. Hence we recommend to use and expect QuadPoints array in Z-order, just as Acrobat and probably most other viewers expect.
    
    Parameters:
    
    quadPoints - an PdfArray of 8 × n numbers specifying the coordinates of n quadrilaterals.
    
    Returns:
    
    this PdfAnnotation instance.
  - setBorderStyle
```
public PdfAnnotation setBorderStyle(PdfDictionary borderStyle)
```
    Sets border style dictionary that has more settings than the array specified for the Border entry (getBorder()). See ISO-320001, Table 166 and getBorderStyle() for more info.
    
    Parameters:
    
    borderStyle - a border style dictionary specifying the line width and dash pattern that shall be used in drawing the annotation’s border.
    
    Returns:
    
    this PdfAnnotation instance.
  - setBorderStyle
```
public PdfAnnotation setBorderStyle(PdfName style)
```
    Setter for the annotation's preset border style. Possible values are
    - STYLE_SOLID - A solid rectangle surrounding the annotation.
    - STYLE_DASHED - A dashed rectangle surrounding the annotation.
    - STYLE_BEVELED - A simulated embossed rectangle that appears to be raised above the surface of the page.
    - STYLE_INSET - A simulated engraved rectangle that appears to be recessed below the surface of the page.
    - STYLE_UNDERLINE - A single line along the bottom of the annotation rectangle.
    See also ISO-320001, Table 166.
    Parameters:
    
    style - The new value for the annotation's border style.
    
    Returns:
    
    The annotation which this method was called on.
    
    See Also:
    
    getBorderStyle()
  - setDashPattern
```
public PdfAnnotation setDashPattern(PdfArray dashPattern)
```
    Setter for the annotation's preset dashed border style. This property has affect only if STYLE_DASHED style was used for the annotation border style (see setBorderStyle(PdfName). See ISO-320001 8.4.3.6, “Line Dash Pattern” for the format in which dash pattern shall be specified.
    
    Parameters:
    
    dashPattern - a dash array defining a pattern of dashes and gaps that shall be used in drawing a dashed border.
    
    Returns:
    
    this PdfAnnotation instance.
  - getBorderStyle
```
public PdfDictionary getBorderStyle()
```
    The dictionaries for some annotation types (such as free text and polygon annotations) can include the BS entry. That entry specifies a border style dictionary that has more settings than the array specified for the Border entry (see getBorder()). If an annotation dictionary includes the BS entry, then the Border entry is ignored. If annotation includes AP (see getAppearanceDictionary()) it takes precedence over the BS entry. For more info on BS entry see ISO-320001, Table 166.
    
    Returns:
    
    PdfDictionary which is a border style dictionary or null if it is not specified.
  - setTitle
```
public PdfAnnotation setTitle(PdfString title)
```
    Sets annotation title. This property affects not all annotation types.
    
    Parameters:
    
    title - a PdfString which value is to be annotation title.
    
    Returns:
    
    this PdfAnnotation instance.
  - getTitle
```
public PdfString getTitle()
```
    Annotation title. For example for markup annotations, the title is the text label that shall be displayed in the title bar of the annotation’s pop-up window when open and active. For movie annotation Movie actions (ISO-320001 12.6.4.9, “Movie Actions”) may use this title to reference the movie annotation.
    
    Returns:
    
    PdfString which value is an annotation title or null if it isn't specifed.
  - setAppearanceCharacteristics
```
public PdfAnnotation setAppearanceCharacteristics(PdfDictionary characteristics)
```
    Sets an appearance characteristics dictionary containing additional information for constructing the annotation’s appearance stream. See ISO-320001, Table 189. This property affects PdfWidgetAnnotation and PdfScreenAnnotation.
    
    Parameters:
    
    characteristics - the PdfDictionary with additional information for appearance stream.
    
    Returns:
    
    this PdfAnnotation instance.
  - getAppearanceCharacteristics
```
public PdfDictionary getAppearanceCharacteristics()
```
    An appearance characteristics dictionary containing additional information for constructing the annotation’s appearance stream. See ISO-320001, Table 189. This property affects PdfWidgetAnnotation and PdfScreenAnnotation.
    
    Returns:
    
    an appearance characteristics dictionary or null if it isn't specified.
  - getAction
```
public PdfDictionary getAction()
```
    An PdfAction to perform, such as launching an application, playing a sound, changing an annotation’s appearance state etc, when the annotation is activated.
    
    Returns:
    
    PdfDictionary which defines the characteristics and behaviour of an action.
  - getAdditionalAction
```
public PdfDictionary getAdditionalAction()
```
    An additional actions dictionary that extends the set of events that can trigger the execution of an action. See ISO-320001 12.6.3 Trigger Events.
    
    Returns:
    
    an additional actions PdfDictionary.
    
    See Also:
    
    getAction()
  - setRectangle
```
public PdfAnnotation setRectangle(PdfArray array)
```
    The annotation rectangle, defining the location of the annotation on the page in default user space units.
    
    Parameters:
    
    array - a PdfArray which specifies a rectangle by two diagonally opposite corners. Typically, the array is of form [llx lly urx ury].
    
    Returns:
    
    this PdfAnnotation instance.
  - getRectangle
```
public PdfArray getRectangle()
```
    The annotation rectangle, defining the location of the annotation on the page in default user space units.
    
    Returns:
    
    a PdfArray which specifies a rectangle by two diagonally opposite corners. Typically, the array is of form [llx lly urx ury].
  - put
```
public PdfAnnotation put(PdfName key,
                         PdfObject value)
```
    Inserts the value into into the underlying PdfDictionary of this PdfAnnotation and associates it with the specified key. If the key is already present in this PdfAnnotation, this method will override the old value with the specified one.
    
    Parameters:
    
    key - key to insert or to override
    
    value - the value to associate with the specified key
    
    Returns:
    
    this PdfAnnotation instance.
  - remove
```
public PdfAnnotation remove(PdfName key)
```
    Removes the specified key from the underlying PdfDictionary of this PdfAnnotation.
    
    Parameters:
    
    key - key to be removed
    
    Returns:
    
    this PdfAnnotation instance.
  - flush
```
public void flush()
```
    To manually flush a PdfObject behind this wrapper, you have to ensure that this object is added to the document, i.e. it has an indirect reference. Basically this means that before flushing you need to explicitly call PdfObjectWrapper.makeIndirect(PdfDocument). For example: wrapperInstance.makeIndirect(document).flush(); Note that not every wrapper require this, only those that have such warning in documentation.
    
    Overrides:
    
    flush in class PdfObjectWrapper<PdfDictionary>
  - isWrappedObjectMustBeIndirect
```
protected boolean isWrappedObjectMustBeIndirect()
```
    Description copied from class: PdfObjectWrapper
    
    Defines if the object behind this wrapper must be an indirect object in the resultant document.
    
    If this method returns true it doesn't necessarily mean that object must be in the indirect state at any moment, but rather defines that when the object will be written to the document it will be transformed into indirect object if it's not indirect yet.
    
    Return value of this method shouldn't depend on any logic, it should return always true or false.
    
    Specified by:
    
    isWrappedObjectMustBeIndirect in class PdfObjectWrapper<PdfDictionary>
    
    Returns:
    
    true if in the resultant document the object behind the wrapper must be indirect, otherwise false.

Class PdfAnnotation

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper

Methods inherited from class java.lang.Object

Field Detail

INVISIBLE

HIDDEN

PRINT

NO_ZOOM

NO_ROTATE

NO_VIEW

READ_ONLY

LOCKED

TOGGLE_NO_VIEW

LOCKED_CONTENTS

HIGHLIGHT_NONE

HIGHLIGHT_INVERT

HIGHLIGHT_OUTLINE

HIGHLIGHT_PUSH

HIGHLIGHT_TOGGLE

STYLE_SOLID

STYLE_DASHED

STYLE_BEVELED

STYLE_INSET

STYLE_UNDERLINE

Marked

Unmarked

Accepted

Rejected

Canceled

Completed

None

MarkedModel

ReviewModel

page

Constructor Detail

PdfAnnotation

PdfAnnotation

Method Detail

makeAnnotation

makeAnnotation

getSubtype

setLayer

setAction

setAdditionalAction

getContents

setContents

setContents

getPageObject

getPage

setPage

getName

setName

getDate

setDate

getFlags

setFlags

setFlag

resetFlag

hasFlag

getAppearanceDictionary

getAppearanceObject

getNormalAppearanceObject

getRolloverAppearanceObject

getDownAppearanceObject

setAppearance

setNormalAppearance

setRolloverAppearance

setDownAppearance

setAppearance

setNormalAppearance

setRolloverAppearance

setDownAppearance

getAppearanceState

setAppearanceState

getBorder

setBorder

getColorObject