com.pdf_tools.fourheights.pdftoolbox.pdf.annotations

Class Annotation

java.lang.Object

com.pdf_tools.fourheights.pdftoolbox.internal.NativeBase

com.pdf_tools.fourheights.pdftoolbox.internal.NativeObject

com.pdf_tools.fourheights.pdftoolbox.pdf.annotations.Annotation

Direct Known Subclasses:

MarkupAnnotation

public class Annotation
extends NativeObject

A page annotation

Method Summary

Modifier and Type	Method and Description
static Annotation	copy(Document targetDocument, Annotation annotation) Copy an annotation
static Annotation	createDynamicObject(long handle)
Rectangle	getBoundingBox() The location on the page (Getter)
boolean	getHidden() The annotation's visibility (Getter)
boolean	getNoPrint() The annotation's visibility when printing (Getter)
boolean	getNoRotate() The annotation's rotation behavior (Getter)
boolean	getNoZoom() The annotation's scaling behavior (Getter)

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

createDynamicObject

public static Annotation createDynamicObject(long handle)

copy

public static Annotation copy(Document targetDocument,
                              Annotation annotation)
                       throws java.io.IOException,
                              ConformanceException

Copy an annotation

Copy an annotation object from an input document to the given targetDocument. The returned object is associated with the given target document but not yet part of it.

Parameters:

targetDocument - the output document with which the returned object is associated

annotation - the annotation to be copied to the targetDocument

Returns:

the copied annotation, associated with the targetDocument

Throws:

java.lang.IllegalArgumentException - if the targetDocument is null

java.lang.IllegalArgumentException - if the targetDocument has already been closed

java.lang.IllegalArgumentException - if the targetDocument is read-only

java.lang.IllegalArgumentException - if the annotation is not associated with an input document

java.lang.IllegalArgumentException - if the annotation argument is null

java.lang.IllegalArgumentException - if the annotation object or the associated input document has already been closed

ConformanceException - The conformance level of the input document is not compatible with the conformance level of the targetDocument.

java.io.IOException - Error reading from the input document or writing to the output document

getBoundingBox

public Rectangle getBoundingBox()
                         throws CorruptException

The location on the page (Getter)

Throws:

java.lang.IllegalStateException - if the object has already been closed

CorruptException - if the PDF is corrupt

getHidden

public boolean getHidden()

The annotation's visibility (Getter)

If true then the annotation is present, but is invisible and not available for user interaction. Depending on the getNoPrint() property it will, however, still be visible when printing.

Throws:

java.lang.IllegalStateException - if the object has already been closed

getNoPrint

public boolean getNoPrint()

The annotation's visibility when printing (Getter)

If true then the annotation is not present in a print output of the document.

Throws:

java.lang.IllegalStateException - if the object has already been closed

getNoZoom

public boolean getNoZoom()

The annotation's scaling behavior (Getter)

If true then the annotation's visual appearance does not scale with the zoom factor of a PDF viewer.

Throws:

java.lang.IllegalStateException - if the object has already been closed

getNoRotate

public boolean getNoRotate()

The annotation's rotation behavior (Getter)

If true then the annotation's visual appearance does not rotate with the rotation set in a PDF viewer.

Throws:

java.lang.IllegalStateException - if the object has already been closed