Class PDAnnotationLink
java.lang.Object
org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotation
org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationLink
- All Implemented Interfaces:
COSObjectable
This is the class that represents a link annotation.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate PDAppearanceHandler
static final String
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.static final String
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.static final String
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.static final String
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.static final String
The type of annotation. -
Constructor Summary
ConstructorsConstructorDescriptionConstructor.PDAnnotationLink
(COSDictionary field) Creates a Link annotation from a COSDictionary, expected to be a correct object definition. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Create the appearance entry for this annotation.void
constructAppearances
(PDDocument document) Create the appearance entry for this annotation.Get the action to be performed when this annotation is to be activated.This will retrieve the border style dictionary, specifying the width and dash pattern used in drawing the line.Get the destination to be displayed when the annotation is activated.Set the highlight mode for when the mouse is depressed.This will set the previous URI action, in case it's needed.float[]
This will retrieve the set of quadpoints which encompass the areas of this annotation which will activate.void
Set the annotation action.void
This will set the border style dictionary, specifying the width and dash pattern used in drawing the line.void
setCustomAppearanceHandler
(PDAppearanceHandler appearanceHandler) Set a custom appearance handler for generating the annotations appearance streams.void
setDestination
(PDDestination dest) The new destination value.void
setHighlightMode
(String mode) Set the highlight mode.void
This will set the previous URI action, in case it needs to be retrieved at later date.void
setQuadPoints
(float[] quadPoints) This will set the set of quadpoints which encompass the areas of this annotation which will activate.Methods inherited from class org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotation
createAnnotation, equals, getAnnotationFlags, getAnnotationName, getAppearance, getAppearanceState, getBorder, getColor, getColor, getContents, getCOSObject, getModifiedDate, getNormalAppearanceStream, getOptionalContent, getPage, getRectangle, getStructParent, getSubtype, hashCode, isHidden, isInvisible, isLocked, isLockedContents, isNoRotate, isNoView, isNoZoom, isPrinted, isReadOnly, isToggleNoView, setAnnotationFlags, setAnnotationName, setAppearance, setAppearanceState, setBorder, setColor, setContents, setHidden, setInvisible, setLocked, setLockedContents, setModifiedDate, setModifiedDate, setNoRotate, setNoView, setNoZoom, setOptionalContent, setPage, setPrinted, setReadOnly, setRectangle, setStructParent, setToggleNoView
-
Field Details
-
customAppearanceHandler
-
HIGHLIGHT_MODE_NONE
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.- See Also:
-
HIGHLIGHT_MODE_INVERT
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.- See Also:
-
HIGHLIGHT_MODE_OUTLINE
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.- See Also:
-
HIGHLIGHT_MODE_PUSH
Constant values of the Text as defined in the PDF 1.6 reference Table 8.19.- See Also:
-
SUB_TYPE
The type of annotation.- See Also:
-
-
Constructor Details
-
PDAnnotationLink
public PDAnnotationLink()Constructor. -
PDAnnotationLink
Creates a Link annotation from a COSDictionary, expected to be a correct object definition.- Parameters:
field
- the PDF object to represent as a field.
-
-
Method Details
-
getAction
Get the action to be performed when this annotation is to be activated. Either this or the destination entry should be set, but not both.- Returns:
- The action to be performed when this annotation is activated.
-
setAction
Set the annotation action. Either this or the destination entry should be set, but not both.- Parameters:
action
- The annotation action.
-
setBorderStyle
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
This will retrieve the border style dictionary, specifying the width and dash pattern used in drawing the line.- Returns:
- the border style dictionary.
-
getDestination
Get the destination to be displayed when the annotation is activated. Either this or the action entry should be set, but not both.- Returns:
- The destination for this annotation.
- Throws:
IOException
- If there is an error creating the destination.
-
getHighlightMode
Set the highlight mode for when the mouse is depressed. See the HIGHLIGHT_MODE_XXX constants.- Returns:
- The string representation of the highlight mode.
-
setHighlightMode
Set the highlight mode. See the HIGHLIGHT_MODE_XXX constants.- Parameters:
mode
- The new highlight mode.
-
setPreviousURI
This will set the previous URI action, in case it needs to be retrieved at later date.- Parameters:
pa
- The previous URI.
-
getPreviousURI
This will set the previous URI action, in case it's needed.- Returns:
- The previous URI.
-
setQuadPoints
public void setQuadPoints(float[] quadPoints) This will set the set of quadpoints which encompass the areas of this annotation which will activate.- Parameters:
quadPoints
- an array representing the set of area covered.
-
getQuadPoints
public float[] getQuadPoints()This will retrieve the set of quadpoints which encompass the areas of this annotation which will activate.- Returns:
- An array of floats representing the quad points.
-
setCustomAppearanceHandler
Set a custom appearance handler for generating the annotations appearance streams.- Parameters:
appearanceHandler
-
-
constructAppearances
public void constructAppearances()Description copied from class:PDAnnotation
Create the appearance entry for this annotation. Not having it may prevent display in some viewers. This method is for overriding in subclasses, the default implementation does nothing.- Overrides:
constructAppearances
in classPDAnnotation
-
constructAppearances
Description copied from class:PDAnnotation
Create the appearance entry for this annotation. Not having it may prevent display in some viewers. This method is for overriding in subclasses, the default implementation does nothing.- Overrides:
constructAppearances
in classPDAnnotation
-