com.itextpdf.kernel.pdf.annot

Class PdfLineAnnotation

java.lang.Object

com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfDictionary>

com.itextpdf.kernel.pdf.annot.PdfAnnotation

com.itextpdf.kernel.pdf.annot.PdfMarkupAnnotation

com.itextpdf.kernel.pdf.annot.PdfLineAnnotation

All Implemented Interfaces:

Serializable

public class PdfLineAnnotation
extends PdfMarkupAnnotation

The purpose of a line annotation is to display a single straight line on the page. When opened, it displays a pop-up window containing the text of the associated note. See also ISO-320001 12.5.6.7 "Line Annotations".

See Also:

Serialized Form

Field Summary

Fields inherited from class com.itextpdf.kernel.pdf.annot.PdfMarkupAnnotation

inReplyTo, popup

Fields inherited from class com.itextpdf.kernel.pdf.annot.PdfAnnotation

Accepted, Canceled, Completed, HIDDEN, HIGHLIGHT_INVERT, HIGHLIGHT_NONE, HIGHLIGHT_OUTLINE, HIGHLIGHT_PUSH, HIGHLIGHT_TOGGLE, INVISIBLE, LOCKED, LOCKED_CONTENTS, Marked, MarkedModel, NO_ROTATE, NO_VIEW, NO_ZOOM, None, page, PRINT, READ_ONLY, Rejected, ReviewModel, STYLE_BEVELED, STYLE_DASHED, STYLE_INSET, STYLE_SOLID, STYLE_UNDERLINE, TOGGLE_NO_VIEW, Unmarked

Constructor Summary

Constructors

Constructor and Description
PdfLineAnnotation(PdfDictionary pdfDictionary) Creates a PdfLineAnnotation instance from the given PdfDictionary that represents annotation object.
PdfLineAnnotation(Rectangle rect, float[] line) Creates a PdfLineAnnotation instance.

Method Summary

Modifier and Type	Method and Description
PdfArray	getCaptionOffset() An array of two numbers that specifies the offset of the caption text from its normal position.
PdfName	getCaptionPosition() A name describing the annotation's caption positioning.
boolean	getContentsAsCaption() If true, the text specified by the PdfName.Contents or PdfName.RC entries (see PdfAnnotation.getContents() and PdfMarkupAnnotation.getRichText()) is replicated as a caption in the appearance of the line.
float	getLeaderLine() Deprecated. use getLeaderLineLength() instead.
float	getLeaderLineExtension() A non-negative number that represents the length of leader line extensions that extend from the line proper 180 degrees from the leader lines.
float	getLeaderLineLength() The length of leader lines in default user space that extend from each endpoint of the line perpendicular to the line itself.
float	getLeaderLineOffset() A non-negative number that represents the length of the leader line offset, which is the amount of empty space between the endpoints of the annotation and the beginning of the leader lines.
PdfArray	getLine() An array of four numbers, [x1 y1 x2 y2], specifying the starting and ending coordinates of the line in default user space.
PdfArray	getLineEndingStyles() An array of two names specifying the line ending styles that is used in drawing the line.
PdfDictionary	getMeasure() A measure dictionary (see ISO-320001, Table 261) that specifies the scale and units that apply to the line annotation.
PdfName	getSubtype() Gets a PdfName which value is a subtype of this annotation.
PdfLineAnnotation	setCaptionOffset(float[] captionOffset) Sets the offset of the caption text from its normal position.
PdfLineAnnotation	setCaptionOffset(PdfArray captionOffset) Sets the offset of the caption text from its normal position.
PdfLineAnnotation	setCaptionPosition(PdfName captionPosition) Sets annotation's caption positioning.
PdfLineAnnotation	setContentsAsCaption(boolean contentsAsCaption) If set to true, the text specified by the PdfName.Contents or PdfName.RC entries (see PdfAnnotation.getContents() and PdfMarkupAnnotation.getRichText()) will be replicated as a caption in the appearance of the line.
PdfLineAnnotation	setLeaderLine(float leaderLine) Deprecated. use setLeaderLineLength(float) instead.
PdfLineAnnotation	setLeaderLineExtension(float leaderLineExtension) Sets the length of leader line extensions that extend from the line proper 180 degrees from the leader lines.
PdfLineAnnotation	setLeaderLineLength(float leaderLineLength) Sets the length of leader lines in default user space that extend from each endpoint of the line perpendicular to the line itself.
PdfLineAnnotation	setLeaderLineOffset(float leaderLineOffset) Sets the length of the leader line offset, which is the amount of empty space between the endpoints of the annotation and the beginning of the leader lines.
PdfLineAnnotation	setLineEndingStyles(PdfArray lineEndingStyles) Sets the line ending styles that are used in drawing the line.
PdfLineAnnotation	setMeasure(PdfDictionary measure) Sets a measure dictionary that specifies the scale and units that apply to the line annotation.

Methods inherited from class com.itextpdf.kernel.pdf.annot.PdfMarkupAnnotation

getBorderEffect, getCreationDate, getDefaultAppearance, getExternalData, getIconName, getInReplyTo, getInReplyToObject, getIntent, getInteriorColor, getJustification, getOpacity, getPopup, getPopupObject, getRectangleDifferences, getReplyType, getRichText, getSubject, getText, setBorderEffect, setCreationDate, setDefaultAppearance, setExternalData, setIconName, setInReplyTo, setIntent, setInteriorColor, setInteriorColor, setJustification, setOpacity, setPopup, setRectangleDifferences, setReplyType, setRichText, setSubject, setText

Methods inherited from class com.itextpdf.kernel.pdf.annot.PdfAnnotation

flush, getAction, getAdditionalAction, getAppearanceCharacteristics, getAppearanceDictionary, getAppearanceObject, getAppearanceState, getBorder, getBorderStyle, getColorObject, getContents, getDate, getDownAppearanceObject, getFlags, getName, getNormalAppearanceObject, getOpen, getPage, getPageObject, getQuadPoints, getRectangle, getRolloverAppearanceObject, getStructParentIndex, getTitle, hasFlag, isWrappedObjectMustBeIndirect, makeAnnotation, makeAnnotation, put, remove, resetFlag, setAction, setAdditionalAction, setAppearance, setAppearance, setAppearanceCharacteristics, setAppearanceState, setBorder, setBorderStyle, setBorderStyle, setColor, setColor, setColor, setContents, setContents, setDashPattern, setDate, setDownAppearance, setDownAppearance, setFlag, setFlags, setLayer, setName, setNormalAppearance, setNormalAppearance, setOpen, setPage, setQuadPoints, setRectangle, setRolloverAppearance, setRolloverAppearance, setStructParentIndex, setTitle

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

Constructor Detail

PdfLineAnnotation

public PdfLineAnnotation(Rectangle rect,
                         float[] line)

Creates a PdfLineAnnotation instance.

Parameters:

rect - the annotation rectangle, defining the location of the annotation on the page in default user space units. See PdfAnnotation.setRectangle(PdfArray).

line - an array of four numbers, [x1 y1 x2 y2], specifying the starting and ending coordinates of the line in default user space. See also getLine().

PdfLineAnnotation

public PdfLineAnnotation(PdfDictionary pdfDictionary)

Creates a PdfLineAnnotation instance from the given PdfDictionary that represents annotation object. This method is useful for property reading in reading mode or modifying in stamping mode.

Parameters:

pdfDictionary - a PdfDictionary that represents existing annotation in the document.

Method Detail

getSubtype

public 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.

Specified by:

getSubtype in class PdfAnnotation

Returns:

subtype of this annotation.

getLine

public PdfArray getLine()

An array of four numbers, [x1 y1 x2 y2], specifying the starting and ending coordinates of the line in default user space. If the PdfName.LL (see getLeaderLine()) entry is present, this value represents the endpoints of the leader lines rather than the endpoints of the line itself.

Returns:

An array of four numbers specifying the starting and ending coordinates of the line in default user space.

getLineEndingStyles

public PdfArray getLineEndingStyles()

An array of two names specifying the line ending styles that is used in drawing the line. The first and second elements of the array shall specify the line ending styles for the endpoints defined, respectively, by the first and second pairs of coordinates, (x1, y1) and (x2, y2), in the PdfName.L array (see getLine(). For possible values see setLineEndingStyles(PdfArray).

Returns:

An array of two names specifying the line ending styles that is used in drawing the line; or null if line endings style is not explicitly defined, default value is [/None /None].

setLineEndingStyles

public PdfLineAnnotation setLineEndingStyles(PdfArray lineEndingStyles)

Sets the line ending styles that are used in drawing the line. The first and second elements of the array shall specify the line ending styles for the endpoints defined, respectively, by the first and second pairs of coordinates, (x1, y1) and (x2, y2), in the PdfName.L array (see getLine(). Possible values for styles are:

• PdfName.Square - A square filled with the annotation's interior color, if any;
• PdfName.Circle - A circle filled with the annotation's interior color, if any;
• PdfName.Diamond - A diamond shape filled with the annotation's interior color, if any;
• PdfName.OpenArrow - Two short lines meeting in an acute angle to form an open arrowhead;
• PdfName.ClosedArrow - Two short lines meeting in an acute angle as in the PdfName.OpenArrow style and connected by a third line to form a triangular closed arrowhead filled with the annotation's interior color, if any;
• PdfName.None - No line ending;
• PdfName.Butt - A short line at the endpoint perpendicular to the line itself;
• PdfName.ROpenArrow - Two short lines in the reverse direction from PdfName.OpenArrow;
• PdfName.RClosedArrow - A triangular closed arrowhead in the reverse direction from PdfName.ClosedArrow;
• PdfName.Slash - A short line at the endpoint approximately 30 degrees clockwise from perpendicular to the line itself;

see also ISO-320001, Table 176 "Line ending styles".

Parameters:

lineEndingStyles - An array of two names specifying the line ending styles that is used in drawing the line.

Returns:

this PdfLineAnnotation instance.

getLeaderLine

@Deprecated
public float getLeaderLine()

Deprecated. use getLeaderLineLength() instead.

The length of leader lines in default user space that extend from each endpoint of the line perpendicular to the line itself. A positive value means that the leader lines appear in the direction that is clockwise when traversing the line from its starting point to its ending point (as specified by PdfName.L (see getLine()); a negative value indicates the opposite direction.

Returns:

a float specifying the length of leader lines in default user space.

setLeaderLine

@Deprecated
public PdfLineAnnotation setLeaderLine(float leaderLine)

Deprecated. use setLeaderLineLength(float) instead.

Sets the length of leader lines in default user space that extend from each endpoint of the line perpendicular to the line itself. A positive value means that the leader lines appear in the direction that is clockwise when traversing the line from its starting point to its ending point (as specified by PdfName.L (see getLine()); a negative value indicates the opposite direction.

Parameters:

leaderLine - a float specifying the length of leader lines in default user space.

Returns:

this PdfLineAnnotation instance.

getLeaderLineLength

public float getLeaderLineLength()

The length of leader lines in default user space that extend from each endpoint of the line perpendicular to the line itself. A positive value means that the leader lines appear in the direction that is clockwise when traversing the line from its starting point to its ending point (as specified by PdfName.L (see getLine()); a negative value indicates the opposite direction.

Returns:

a float specifying the length of leader lines in default user space.

setLeaderLineLength

public PdfLineAnnotation setLeaderLineLength(float leaderLineLength)

Sets the length of leader lines in default user space that extend from each endpoint of the line perpendicular to the line itself. A positive value means that the leader lines appear in the direction that is clockwise when traversing the line from its starting point to its ending point (as specified by PdfName.L (see getLine()); a negative value indicates the opposite direction.

Parameters:

leaderLineLength - a float specifying the length of leader lines in default user space.

Returns:

this PdfLineAnnotation instance.

getLeaderLineExtension

public float getLeaderLineExtension()

A non-negative number that represents the length of leader line extensions that extend from the line proper 180 degrees from the leader lines.

Returns:

a non-negative float that represents the length of leader line extensions; or if the leader line extension is not explicitly set, returns the default value, which is 0.

setLeaderLineExtension

public PdfLineAnnotation setLeaderLineExtension(float leaderLineExtension)

Sets the length of leader line extensions that extend from the line proper 180 degrees from the leader lines. This value shall not be set unless PdfName.LL (see setLeaderLine(float)) is set.

Parameters:

leaderLineExtension - a non-negative float that represents the length of leader line extensions.

Returns:

this PdfLineAnnotation instance.

getLeaderLineOffset

public float getLeaderLineOffset()

A non-negative number that represents the length of the leader line offset, which is the amount of empty space between the endpoints of the annotation and the beginning of the leader lines.

Returns:

a non-negative number that represents the length of the leader line offset, or null if leader line offset is not set.

setLeaderLineOffset

public PdfLineAnnotation setLeaderLineOffset(float leaderLineOffset)

Sets the length of the leader line offset, which is the amount of empty space between the endpoints of the annotation and the beginning of the leader lines.

Parameters:

leaderLineOffset - a non-negative number that represents the length of the leader line offset.

Returns:

this PdfLineAnnotation instance.

getContentsAsCaption

public boolean getContentsAsCaption()

If true, the text specified by the PdfName.Contents or PdfName.RC entries (see PdfAnnotation.getContents() and PdfMarkupAnnotation.getRichText()) is replicated as a caption in the appearance of the line.

Returns:

true, if the annotation text is replicated as a caption, false otherwise. If this property is not set, default value is used which is false.

setContentsAsCaption

public PdfLineAnnotation setContentsAsCaption(boolean contentsAsCaption)

If set to true, the text specified by the PdfName.Contents or PdfName.RC entries (see PdfAnnotation.getContents() and PdfMarkupAnnotation.getRichText()) will be replicated as a caption in the appearance of the line.

Parameters:

contentsAsCaption - true, if the annotation text should be replicated as a caption, false otherwise.

Returns:

this PdfLineAnnotation instance.

getCaptionPosition

public PdfName getCaptionPosition()

A name describing the annotation's caption positioning. Valid values are PdfName.Inline, meaning the caption is centered inside the line, and PdfName.Top, meaning the caption is on top of the line.

Returns:

a name describing the annotation's caption positioning, or null if the caption positioning is not explicitly defined (in this case the default value is used, which is PdfName.Inline).

setCaptionPosition

public PdfLineAnnotation setCaptionPosition(PdfName captionPosition)

Sets annotation's caption positioning. Valid values are PdfName.Inline, meaning the caption is centered inside the line, and PdfName.Top, meaning the caption is on top of the line.

Parameters:

captionPosition - a name describing the annotation's caption positioning.

Returns:

this PdfLineAnnotation instance.

getMeasure

public PdfDictionary getMeasure()

A measure dictionary (see ISO-320001, Table 261) that specifies the scale and units that apply to the line annotation.

Returns:

a PdfDictionary that represents a measure dictionary.

setMeasure

public PdfLineAnnotation setMeasure(PdfDictionary measure)

Sets a measure dictionary that specifies the scale and units that apply to the line annotation.

Parameters:

measure - a PdfDictionary that represents a measure dictionary, see ISO-320001, Table 261 for valid contents specification.

Returns:

this PdfLineAnnotation instance.

getCaptionOffset

public PdfArray getCaptionOffset()

An array of two numbers that specifies the offset of the caption text from its normal position. The first value is the horizontal offset along the annotation line from its midpoint, with a positive value indicating offset to the right and a negative value indicating offset to the left. The second value is the vertical offset perpendicular to the annotation line, with a positive value indicating a shift up and a negative value indicating a shift down.

Returns:

a PdfArray of two numbers that specifies the offset of the caption text from its normal position, or null if caption offset is not explicitly specified (in this case a default value is used, which is [0, 0]).

setCaptionOffset

public PdfLineAnnotation setCaptionOffset(PdfArray captionOffset)

Sets the offset of the caption text from its normal position.

Parameters:

captionOffset - a PdfArray of two numbers that specifies the offset of the caption text from its normal position. The first value defines the horizontal offset along the annotation line from its midpoint, with a positive value indicating offset to the right and a negative value indicating offset to the left. The second value defines the vertical offset perpendicular to the annotation line, with a positive value indicating a shift up and a negative value indicating a shift down.

Returns:

this PdfLineAnnotation instance.

setCaptionOffset

public PdfLineAnnotation setCaptionOffset(float[] captionOffset)

Sets the offset of the caption text from its normal position.

Parameters:

captionOffset - an array of two floats that specifies the offset of the caption text from its normal position. The first value defines the horizontal offset along the annotation line from its midpoint, with a positive value indicating offset to the right and a negative value indicating offset to the left. The second value defines the vertical offset perpendicular to the annotation line, with a positive value indicating a shift up and a negative value indicating a shift down.

Returns:

this PdfLineAnnotation instance.