public abstract class PdfAnnot extends Object implements Cloneable, Usable
form fields
.
An "annotation rectangle" defines the position and size of an annotation on a page. This rectangle may be specified by coordinates of its top-left corner, width, and height. An annotation rectangle has to be compulsorily specified for an annotation. Even when a default constructor is used to create an annotation, an annotation rectangle should be specified subsequently. These specifications are applied in a literal sense. As a result, the actual position and size of an annotation on a page is wholly dependent on whatever measurement unit that is currently applicable.
Adding the same annotation to pages with different default measurement units, for example, will cause a shift in their relative positions.
PdfWriter writer = PdfWriter.fileWriter( "PdfAnnot_INTRO_Example.pdf"); PdfDocument document = new PdfDocument(writer); PdfPage page_point = new PdfPage(); PdfPage page_pixel = new PdfPage(); page_pixel.setMeasurementUnit(PdfMeasurement.MU_PIXELS); page_point.setMeasurementUnit(PdfMeasurement.MU_POINTS); // Creates a text annotation object PdfTextAnnot tAnnot = new PdfTextAnnot(); // Specifies properties of the annotation tAnnot.setColor(Color.PINK); tAnnot.setIconName(PdfTextAnnot.ICON_KEY); tAnnot.setTitle("Attn: All"); tAnnot.setSubject("EOD Deliverables"); tAnnot.setContents( "Please check this document. It has some errors."); tAnnot.setFlags(PdfAnnot.FLAG_PRINT); tAnnot.setOpen(true); // Specifies the annotation rectangle of the annotation tAnnot.setRect(300, 200, 100, 100); // Adds clones of the same annotation to pages with // different measurement units // Makes them appear in different positions, relative to each other page_pixel.addAnnotation(tAnnot); page_point.addAnnotation((PdfAnnot) tAnnot.clone()); document.add(page_pixel); document.add(page_point); document.setOpenAfterSave(true); document.write(); writer.dispose();
Modifier and Type | Field and Description |
---|---|
static int |
ANNOT_TYPE_CARET
Caret annotation type.
|
static int |
ANNOT_TYPE_CIRCLE
Circle annotation type.
|
static int |
ANNOT_TYPE_FILE_ATTACHMENT
File attachment annotation type.
|
static int |
ANNOT_TYPE_FREE_TEXT
Free text annotation type.
|
static int |
ANNOT_TYPE_INK
Ink annotation type.
|
static int |
ANNOT_TYPE_LINE
Line annotation type.
|
static int |
ANNOT_TYPE_LINK
Link annotation type.
|
static int |
ANNOT_TYPE_MARKUP
Markup annotation type.
|
static int |
ANNOT_TYPE_POLYGON
Polygon annotation type.
|
static int |
ANNOT_TYPE_POLYLINE
Polyline annotation type.
|
static int |
ANNOT_TYPE_POPUP
Pop-up annotation type.
|
static int |
ANNOT_TYPE_SQUARE
Square annotation type.
|
static int |
ANNOT_TYPE_STAMP
Rubber stamp annotation type.
|
static int |
ANNOT_TYPE_TEXT
Text annotation type.
|
static int |
ANNOT_TYPE_WATERMARK
Watermark annotation type.
|
static int |
BORDERSTYLE_BEVELED
Annotation border style specifying a border drawn as
an embossed rectangle that appears to have risen above the
surface of the page.
|
static int |
BORDERSTYLE_DASHED
Annotation border style specifying a border drawn as a
dashed rectangle around the annotation.
|
static int |
BORDERSTYLE_INSET
Annotation border style specifying a border drawn as
an engraved rectangle that appears to have sunken below the
surface of the page.
|
static int |
BORDERSTYLE_SOLID
Annotation border style specifying a border drawn as a
solid rectangle around the annotation.
|
static int |
BORDERSTYLE_UNDERLINE
Annotation border style specifying a bottom-line-only border.
|
static int |
FLAG_HIDDEN
Flag to indicate whether an annotation is displayed, printed,
or allowed to interact with the user, irrespective of the
annotation's type or the existence of an
annotation handler.
|
static int |
FLAG_INVISIBLE
Flag to indicate whether an annotation is displayed using its
appearance stream if it does not belong to one of the standard
annotation types and if no
annotation handler is specified.
|
static int |
FLAG_LOCKED
Flag to indicate whether an annotation is not allowed to be
deleted or have its properties modified by the user.
|
static int |
FLAG_NO_ROTATE
Flag to indicate whether an annotation is rotated in sync
with rotation of its page.
|
static int |
FLAG_NO_VIEW
Flag to indicate whether an annotation is displayed or allowed
to interact with the user.
|
static int |
FLAG_NO_ZOOM
Flag to indicate whether an annotation is magnified in sync
with zoom level of its page.
|
static int |
FLAG_PRINT
Flag to indicate whether an annotation is printed when the
page is printed.
|
static int |
FLAG_READONLY
Flag to indicate whether an annotation is not allowed to
interact with the user.
|
static int |
FLAG_TOGGLE_NO_VIEW
Flag to indicate whether the implementation of the
FLAG_NO_VIEW of an annotation is to be inverted. |
INCHES_TO_POINTS, MM_TO_INCHES, MM_TO_POINTS, PDF_A, PDF_AA, PDF_AC, PDF_ACROFORM, PDF_ACTION, PDF_ALTERNATEPRESENTATIONS, PDF_ANNOT, PDF_ANNOT_DEFAULT_TITLE, PDF_ANNOT_NAME, PDF_ANNOT_SUBJECT, PDF_ANNOTS, PDF_AP, PDF_ARRAYEND, PDF_ARRAYSTART, PDF_ARTBOX, PDF_AS, PDF_ASCENT, PDF_ASCII85, PDF_ASCII85_NEW, PDF_ASCIIHEX, PDF_ASCIIHEX_NEW, PDF_AuthEvent, PDF_AUTHOR, PDF_AVGWIDTH, PDF_B, PDF_BASEFONT, PDF_BBOX, PDF_BC, PDF_BE, PDF_BEFOREFORMAT, PDF_BEGINTEXT, PDF_BG, PDF_BINARYDATA, PDF_BITS_PER_COMPONENT, PDF_BL, PDF_BLEEDBOX, PDF_BLINDS, PDF_BMC, PDF_BORDER, PDF_BOX, PDF_BS, PDF_BTN, PDF_BYTERANGE, PDF_C, PDF_CA, PDF_CA_SMALL, PDF_CAPHEIGHT, PDF_CARETANNOT, PDF_CARRIAGE, PDF_CATALOG, PDF_CENTER_WINDOW, PDF_CF, PDF_CFM, PDF_CH, PDF_CID_TO_GID_MAP, PDF_CIDFONT_TYPE0, PDF_CIDFONT_TYPE1, PDF_CIDFONT_TYPE2, PDF_CIDSYSTEM_INFO, PDF_CIRCLEANNOT, PDF_CL, PDF_CM, PDF_COLOMNS, PDF_COLOR, PDF_COLORSPACE, PDF_COLORSPACE_CALGRAY, PDF_COLORSPACE_CALRGB, PDF_COLORSPACE_DEVICEN, PDF_COLORSPACE_ICCBASED, PDF_COLORSPACE_LAB, PDF_COLORSPACE_SEPARATION, PDF_CONTACTINFO, PDF_CONTENTS, PDF_COUNT, PDF_COVER, PDF_CREATIONDATE, PDF_CREATOR, PDF_CROPBOX, PDF_CS, PDF_CSP, PDF_D, PDF_DA, PDF_DATE, PDF_DATE_FORMAT, PDF_DCTDECODE, PDF_DCTDECODE_NEW, PDF_DECODEPARMS, PDF_DESC, PDF_DESCENDANT, PDF_DESCENDANT_FONTS, PDF_DESCENDENTFONTS, PDF_DESCENT, PDF_DESTINATION, PDF_DESTS, PDF_DEVICE_CMYK, PDF_DEVICE_GRAY, PDF_DEVICE_RGB, PDF_DI, PDF_DICTEND, PDF_DICTSTART, PDF_DIFFERENCES, PDF_DIRECTION, PDF_DISPLAY_DOCTITLE, PDF_DISPLAY_DURATION, PDF_DISSOLVE, PDF_DM, PDF_DOC_SUBJECT, PDF_DOCMDP, PDF_DOS, PDF_DP, PDF_DR, PDF_DS, PDF_DV, PDF_DW, PDF_E, PDF_EF, PDF_EMBEDDEDFILE, PDF_EMBEDDEDFILES, PDF_EMC, PDF_ENCODING, PDF_ENCRYPT, PDF_ENCRYPTMETADATA, PDF_ENDOBJ, PDF_ENDPATH, PDF_ENDSTREAM, PDF_ENDTEXT, PDF_EOCLIP, PDF_EOF, PDF_EXTGSTATE, PDF_F, PDF_FADE, PDF_FALSE, PDF_FDESCRIPTOR, PDF_FIELD_FLAG, PDF_FIELDS, PDF_FILEATTACHMENTANNOT, PDF_FILESPEC, PDF_FILTER, PDF_FIRST, PDF_FIRST_PAGE, PDF_FIRSTCHAR, PDF_FIT, PDF_FIT_WINDOW, PDF_FITB, PDF_FITBH, PDF_FITBV, PDF_FITH, PDF_FITR, PDF_FITV, PDF_FIXEDPRINT, PDF_FLAGS, PDF_FLATE, PDF_FLATE_NEW, PDF_FLY, PDF_FO, PDF_FONT, PDF_FONTBBOX, PDF_FONTDESCRIPTOR, PDF_FONTFILE, PDF_FONTFILE_2, PDF_FontFile_3, PDF_FONTFILE2, PDF_FONTNAME, PDF_FONTNAMEPREFIX, PDF_FORM, PDF_FORMFEED, PDF_FORMFONTPREFIX, PDF_FREE_TEXT_CALLOUT, PDF_FREE_TEXT_TYPEWRITER, PDF_FREETEXTANNOT, PDF_FS, PDF_FT, PDF_FULLSCREEN, PDF_GLITTER, PDF_GOTO_ACTION, PDF_GROUP, PDF_GS, PDF_H, PDF_HEADER, PDF_HEIGHT, PDF_HEXSTRINGEND, PDF_HEXSTRINGSTART, PDF_HIDE_MENUBAR, PDF_HIDE_TOOLBAR, PDF_HIDE_WINDOWUI, PDF_HIGHLIGHT, PDF_HORIZ_STEM, PDF_HORIZONTAL, PDF_I, PDF_IC, PDF_ID, PDF_IDS, PDF_IF, PDF_IMAGE, PDF_IMAGEB, PDF_IMAGEC, PDF_IMAGEI, PDF_IMPORTDATA, PDF_INDEX, PDF_INDEXED, PDF_INFO, PDF_INK, PDF_INKLIST, PDF_INWARD, PDF_IT, PDF_ITALANGLE, PDF_IX, PDF_JAVASCRIPT, PDF_JAVASCRIPT_ACTION, PDF_JS, PDF_KEYSTROKE, PDF_KEYWORDS, PDF_KIDS, PDF_L, PDF_L2R, PDF_LANG, PDF_LAST, PDF_LAST_PAGE, PDF_LASTCHAR, PDF_LAUNCH_ACTION, PDF_LE, PDF_LEGAL, PDF_LENGTH, PDF_LENGTH_1, PDF_LENGTH_2, PDF_LENGTH_3, PDF_LF, PDF_LINEANNOT, PDF_LINKANNOT, PDF_LITERALSTRINGEND, PDF_LITERALSTRINGSTART, PDF_LOCATION, PDF_LZWDECODE, PDF_M, PDF_MAC, PDF_MARKINFO, PDF_MATRIX, PDF_MAXLEN, PDF_MAXWIDTH, PDF_MEDIABOX, PDF_METADATA, PDF_MISSINGWIDTH, PDF_MK, PDF_MODDATE, PDF_N, PDF_NAME, PDF_NAMED, PDF_NAMED_ACT_FIND, PDF_NAMED_ACT_OPEN, PDF_NAMED_ACT_PRINT, PDF_NAMED_ACT_SEARCH, PDF_NAMES, PDF_NAMESTART, PDF_NEEDAPPEARANCES, PDF_NEWLINE, PDF_NEWWINDOW, PDF_NEXT, PDF_NEXT_PAGE, PDF_NO_COMP_OBJ, PDF_NONFULLSCREEN_PAGEMODE, PDF_NULL, PDF_O, PDF_OBJ, PDF_OBJSTREAM, PDF_OCPROPERTIES, PDF_OFF, PDF_ONECOLUMN, PDF_OPEN, PDF_OPEN_ACTION, PDF_OPT, PDF_OUTLINES, PDF_OUTPUTINTENTS, PDF_OUTWARD, PDF_P, PDF_PAGE, PDF_PAGECLOSE, PDF_PAGEINVISIBLE, PDF_PAGELABELS, PDF_PAGELAYOUT, PDF_PAGEMODE, PDF_PAGEOPEN, PDF_PAGES, PDF_PAGEVISIBLE, PDF_PAINT_TYPE, PDF_PARAMS, PDF_PARENT, PDF_PATTERN, PDF_PATTERN_TYPE, PDF_PBD, PDF_PC, PDF_PDC, PDF_PDF, PDF_PERMS, PDF_PFD, PDF_PH, PDF_PIECEINFO, PDF_POLYGONANNOT, PDF_POLYLINEANNOT, PDF_POPUP, PDF_PREDICTOR, PDF_PREV, PDF_PREV_PAGE, PDF_PROCSET, PDF_PRODUCER, PDF_PROPERTIES, PDF_PUSH, PDF_PV, PDF_Q, PDF_QUADPOINTS, PDF_R, PDF_R2L, PDF_RC, PDF_RD, PDF_RE, PDF_REASON, PDF_RECALCULATE, PDF_RECT, PDF_REMOTEGOTO_ACTION, PDF_RENDITIONS, PDF_REPLACE, PDF_RESET_FORM, PDF_RESOURCES, PDF_RESTORE_GS, PDF_RI, PDF_ROOT, PDF_ROTATE, PDF_RUNLENGTH, PDF_RUNLENGTH_NEW, PDF_S, PDF_SCN, PDF_SHADING, PDF_SHOWIMG, PDF_SHOWTEXT, PDF_SHOWTEXT_TJ, PDF_SIG, PDF_SIG_FILTER_ADOBE_PPKLITE, PDF_SIG_FILTER_ADOBE_PPKMS, PDF_SIG_SUBFILTER_ADBE_PKCS7_DETACHED, PDF_SIG_SUBFILTER_ADBE_PKCS7_SHA1, PDF_SINGLE_QUOTES, PDF_SINGLEPAGE, PDF_SIZE, PDF_SP, PDF_SPIDERINFO, PDF_SPLIT, PDF_SQUAREANNOT, PDF_SQUIGGLY, PDF_SS, PDF_STAMPANNOT, PDF_STARTXREF, PDF_StmF, PDF_STORE_GS, PDF_STREAM, PDF_StrF, PDF_STRIKEOUT, PDF_STRUCT_TREE, PDF_SUBFILTER, PDF_SUBMIT_FORM, PDF_SUBTYPE, PDF_T, PDF_TAB, PDF_TEMPLATES, PDF_TEXT, PDF_TEXTANNOT, PDF_TEXTCHARSPACE, PDF_TEXTDIMENSION, PDF_TEXTFONT, PDF_TEXTHORIZONTALSCALE, PDF_TEXTLEAD, PDF_TEXTMATRIX, PDF_TEXTNEWLINESTART, PDF_TEXTRENDER, PDF_TEXTWORDSPACE, PDF_THREADS, PDF_THUMB, PDF_TILING_TYPE, PDF_TITLE, PDF_TJ_OPERAND_END, PDF_TJ_OPERAND_START, PDF_TM, PDF_TOUNICODE, PDF_TP, PDF_TRAILER, PDF_TRANSITION, PDF_TRIMBOX, PDF_TRUE, PDF_TRUETYPE, PDF_TU, PDF_TWOCOLUMN_LEFT, PDF_TWOCOLUMN_RIGHT, PDF_TWOPAGE_LEFT, PDF_TWOPAGE_RIGHT, PDF_TX, PDF_TYPE, PDF_TYPE0, PDF_TYPE1, PDF_U, PDF_UNCOVER, PDF_UNDERLINE, PDF_UNIX, PDF_URI_ACTION, PDF_URL, PDF_URLS, PDF_USEATTACHMENTS, PDF_USENONE, PDF_USEOC, PDF_USEOUTLINES, PDF_USETHUMBS, PDF_V, PDF_VALUECHANGE, PDF_VERSION, PDF_VERT_STEM, PDF_VERTICAL, PDF_VERTICES, PDF_VIEWER_PREFERENCES, PDF_W, PDF_WATERMARKANNOT, PDF_WIDGET, PDF_WIDTH, PDF_WIDTHS, PDF_WINANSIENCODING, PDF_WIPE, PDF_X, PDF_XML, PDF_XOBJECT, PDF_XREF, PDF_XREFSTMOFFSET, PDF_XREFSTREAM, PDF_XSTEP, PDF_XYZ, PDF_YES, PDF_YSTEP, PIXEL_PER_INCH, RUBICON_EMBEDDED, SITE, TEXT, TWIPS_TO_POINTS
Modifier and Type | Method and Description |
---|---|
void |
delete()
Removes the form field or annotation from the form.
|
String |
getAnnotName()
Returns annotation name.
|
int |
getBorderStyle()
Returns constant identifying annotation's border style.
|
double |
getBorderWidth()
Returns width of this annotation's border.
|
double |
getBottom()
Returns distance from top edge of page to bottom edge of this
annotation's annotation rectangle.
|
Color |
getColor()
Returns color of this annotation's popup.
|
String |
getContents()
Returns text displayed by this annotation.
|
int[] |
getDashPattern()
Returns an array containing lengths of dashes and gaps in this
annotation's
dash pattern.
|
int |
getFlags()
Returns combined value of flags representing various
characteristics of this annotation.
|
double |
getLeft()
Returns distance from left edge of page to left edge of this
annotation's annotation rectangle.
|
PdfRect |
getRect()
Returns annotation rectangle of this annotation.
|
double |
getRight()
Returns distance from left edge of page and right edge of this
annotation's annotation rectangle.
|
String |
getSubject()
Returns text used as subject of this annotation's contents.
|
String |
getTitle()
Returns text used in this annotation's title bar.
|
double |
getTop()
Returns distance from top edge of page to top edge of this
annotation's rectangle.
|
int |
getType()
Returns type of the annotation.
|
int |
hashCode() |
boolean |
isDeleted() |
boolean |
isShowRect()
Returns whether this annotation's border is displayed.
|
void |
setAnnotName(String name)
Specifies unique name for this annotation in its document.
|
void |
setBorderStyle(int borderStyle)
Specifies this annotation's border style.
|
void |
setBorderWidth(double borderWidth)
Specifies width of this annotation's border.
|
void |
setColor(Color color)
Specifies color of this annotation's popup.
|
void |
setContents(String contents)
Specifies contents for this annotation.
|
void |
setDashPattern(int[] dashPattern)
Specifies lengths of dashes and gaps for this annotation's
dash pattern.
|
void |
setFlags(int flags)
Specifies flags representing various characteristics of this
annotation.
|
void |
setRect(double x,
double y,
double width,
double height)
|
void |
setRect(double x,
double y,
double width,
double height,
int measurementUnit)
Specifies
annotation rectangle for this annotation in specified
measurement unit.
|
void |
setRect(PdfRect rect)
Specifies
PdfRect object as
annotation rectangle
for this annotation. |
void |
setRect(PdfRect rect,
int measurementUnit)
Specifies
PdfRect object as
annotation rectangle for this annotation in specified
measurement unit. |
void |
setRect(Rectangle rect)
Specifies
Rectangle object as
annotation rectangle for this annotation. |
void |
setShowRect(boolean showRect)
Specifies whether this annotation's border needs to be
displayed.
|
void |
setSubject(String subject)
Specifies text to be used as subject of this annotation.
|
void |
setTitle(String title)
Specifies text to be displayed in title bar of this
annotation's popup window.
|
public static final int FLAG_INVISIBLE
public static final int FLAG_HIDDEN
public static final int FLAG_PRINT
public static final int FLAG_NO_ZOOM
public static final int FLAG_NO_ROTATE
public static final int FLAG_NO_VIEW
FLAG_PRINT
flag.FLAG_TOGGLE_NO_VIEW
,
Constant Field Valuespublic static final int FLAG_READONLY
public static final int FLAG_LOCKED
public static final int FLAG_TOGGLE_NO_VIEW
FLAG_NO_VIEW
of an annotation is to be inverted.public static final int BORDERSTYLE_SOLID
public static final int BORDERSTYLE_DASHED
public static final int BORDERSTYLE_BEVELED
public static final int BORDERSTYLE_INSET
public static final int BORDERSTYLE_UNDERLINE
public static final int ANNOT_TYPE_FILE_ATTACHMENT
public static final int ANNOT_TYPE_FREE_TEXT
public static final int ANNOT_TYPE_INK
public static final int ANNOT_TYPE_LINE
public static final int ANNOT_TYPE_MARKUP
public static final int ANNOT_TYPE_POLYLINE
public static final int ANNOT_TYPE_POLYGON
public static final int ANNOT_TYPE_POPUP
public static final int ANNOT_TYPE_STAMP
public static final int ANNOT_TYPE_TEXT
public static final int ANNOT_TYPE_LINK
public static final int ANNOT_TYPE_CARET
public static final int ANNOT_TYPE_SQUARE
public static final int ANNOT_TYPE_CIRCLE
public static final int ANNOT_TYPE_WATERMARK
public int getType()
ANNOT_TYPE_CARET
,
ANNOT_TYPE_WATERMARK
public String getSubject()
public void setSubject(String subject)
subject
- text to be used as subject of the annotationgetSubject()
public String getTitle()
setTitle(String)
public void setTitle(String title)
title
- text to be displayed in title bar of the
annotation's popup windowgetTitle()
public Color getColor()
setColor(Color)
public void setColor(Color color)
color
- color of the annotation's popupgetColor()
public String getContents()
setContents(String)
public void setContents(String contents)
contents
- contents of the annotationgetContents()
public final int getFlags()
setFlags(int)
public final void setFlags(int flags)
flags
- combined value of flags representing various
characteristics of this annotationgetFlags()
public String getAnnotName()
getAnnotName()
public void setAnnotName(String name)
name
- unique name for the annotationgetAnnotName()
public double getBottom()
public double getLeft()
public double getRight()
public double getTop()
public int getBorderStyle()
setBorderStyle(int)
public void setBorderStyle(int borderStyle)
borderStyle
- constant specifying annotation's border stylegetBorderStyle()
public int[] getDashPattern()
setDashPattern(int[])
public void setDashPattern(int[] dashPattern)
BORDERSTYLE_DASHED
using the
setBorderStyle(int)
method and the border must be set
to be displayed using the setShowRect(boolean)
method.dashPattern
- array containing lengths of dashes and gaps for
this annotation's dash patterngetDashPattern()
public double getBorderWidth()
setBorderWidth(double)
public void setBorderWidth(double borderWidth)
borderWidth
- width of the annotation's bordergetBorderWidth()
public boolean isShowRect()
setShowRect(boolean)
public void setShowRect(boolean showRect)
showRect
- whether the annotation's border needs to be
displayedisShowRect()
public PdfRect getRect()
setRect(double, double, double, double)
,
setRect(double, double, double, double, int)
,
setRect(PdfRect)
,
setRect(PdfRect, int)
,
setRect(Rectangle)
public void setRect(PdfRect rect)
PdfRect
object as
annotation rectangle
for this annotation.
The position and size of the rectangle are applied in the default measurement unit of the page to which the annotation is added.
public void setRect(PdfRect rect, int measurementUnit)
PdfRect
object as
annotation rectangle for this annotation in specified
measurement unit.public void setRect(double x, double y, double width, double height)
x
, y
)
with specified width and height.
The position (x
, y
), and dimensions
width
and height
are applied in the
default measurement unit of the page to which the annotation
is added.
public void setRect(double x, double y, double width, double height, int measurementUnit)
x
- x-coordinate of the annotation rectangley
- y-coordinate of the annotation rectanglewidth
- width of the annotation rectangleheight
- height of the annotation rectanglemeasurementUnit
- measurement unit with which the annotation rectangle
is specifiedgetRect()
public void setRect(Rectangle rect)
Rectangle
object as
annotation rectangle for this annotation.public boolean isDeleted()
public void delete()