Stroke color (alias of StrokeColor).
Measurement info of a measurement annotation; null when not a measurement annotation.
Measurement info of a measurement annotation; null when not a measurement annotation.
Result precision (0.01 for two decimals).
Result precision (0.01 for two decimals).
Whether the rotation handle is shown when selected (property form of hasRotationControlEnabled / enableRotationControl / disableRotationControl).
Whether the rotation handle is shown when selected (property form of hasRotationControlEnabled / enableRotationControl / disableRotationControl).
Scale [[page value, unit], [real value, unit]]; when set without measurement info, one is created from the annotation type.
Scale [[page value, unit], [real value, unit]]; when set without measurement info, one is created from the annotation type.
Creates a file attachment annotation (PushPin icon, 20 x 20 pt by default).
Optionalinit: AnnotationInit
Initial property values.
Adds a listener (annotations are EventHandlers; form widgets fire focus / blur of WidgetAnnotation.Events).
Optionaloptions: { once?: boolean }
Optionalonce?: booleanRemove the listener after it is called once.
Links a reply to this annotation (no effect if already linked). Does not add it to the document.
The reply annotation.
Recomputes the bounding box from the content; unchanged in the base class (geometric types compute from their points).
Removes a custom data entry; commit with updateAnnotation afterwards.
Custom data key.
Changes this annotation from an XFDF element (or a whole XFDF containing it): the element's name is replaced with this annotation's Id and imported, updating in place.
Hides the rotation handle when the annotation is selected.
Icon (same geometry as the appearance written to the file); drawn before the appearance bitmap arrives and during drag previews.
Shows the rotation handle when the annotation is selected.
Id of the content editing element this annotation represents; always undefined (content editing does not use annotations).
Always undefined.
Type of the content editing element this annotation represents; always undefined (content editing does not use annotations).
Always undefined.
Gets the text contents (/Contents) of the annotation.
The contents; an empty string when none.
Gets a custom data value stored on the annotation.
Custom data key.
The value; an empty string when the key is missing.
Gets the contents of the attached file. Throws when there is no embedded file.
The file contents (typed with the MIME type when known).
File name and MIME type (attachments read from the file have a file name only after getFileData / getFullFileMetadata).
Gets the file name of the attachment.
The file name, or null when unknown.
File contents, file name and MIME type (file name without the path).
Gets the annotations grouped under this one.
The group members.
Gets the height of the bounding box.
Height in PDF points.
Measurement result text (such as "L = 1.00 ft"), generated by the engine; an empty string when not a measurement annotation.
Gets the point of the bounding box that stays fixed while zooming a NoZoom annotation.
A copy of the point; x and y are fractions of the width and height (0 to 1), default { x: 0, y: 0 }.
Horizontal position as a fraction of the width (0 to 1).
Vertical position as a fraction of the height (0 to 1).
Gets the page the annotation is on.
The page number (1-based).
Previous interactive page transition, or the page at first query if none was recorded. Plain PageNumber writes do not imply a pointer transition. Page remapping resets this baseline. Viewer state only: not part of the PDF or annotation undo properties.
Gets the bounding box.
The bounding box in page coordinates (PDF points).
Margin by which the bounding box exceeds the geometry; 0 in the base class.
Gets the replies to this annotation (linked annotations that are not group members).
The reply annotations.
Gets the rich text style of the contents.
A copy of the style (character position to CSS style), or null when none.
State of the latest review state reply (a hidden note with State); an empty string when none.
The most specific class name (the last of types).
The unrotated box as { x, y, width, height } (getUnrotatedDimensions, a runtime method not declared in the d.ts; same as getUnrotatedBox, optionally given a rectangle in place of the annotation's own, derived by the annotation's Rotation).
Optionalrect: Core.Annotations.RectHeight in PDF points.
Width in PDF points.
Left edge in PDF points.
Top edge in PDF points.
Point-defined annotations: viewport coordinates of each point; others log a warning and return an empty array.
Point-defined annotations: gets one point in viewport coordinates.
Zero-based point index.
The document viewer used to convert the coordinates.
The point, or null when the annotation is not point-defined or the index is out of range.
Position and rotation of the bounding box in the viewport.
Gets the width of the bounding box.
Width in PDF points.
Gets the left edge of the bounding box.
X in PDF points.
Gets the top edge of the bounding box.
Y in PDF points.
Shows the rotation handle when selected (the AnnotationManager rotation option must be on too; only point-defined annotations can rotate, see rotatable in tools/annotation-select-tool.ts).
Whether this is a content editing placeholder; always false (content editing does not use annotations).
Always false.
Whether this annotation is a member of a group (has InReplyTo and ReplyType 'group').
True for a group member.
Whether the annotation is in content editing focus mode; always false (content editing does not use annotations).
Optional_contentEditManager: unknown
Unused.
Always false.
Internal annotation (not listed or exported); there are no such annotations here.
Appears when printing: not hidden, printable, not a reply.
Whether this annotation is a reply to another annotation (has InReplyTo and is not a group member).
True for a reply.
Whether the annotation class or one of its base classes has the given name (such as 'MarkupAnnotation' or 'WidgetAnnotation').
Class name to check.
True when the name is in the class chain.
Invisible when hidden (/F Hidden) or not viewed (NoView).
Whether this is a form field widget; false in the base class.
True for widget annotations.
Removes all event listeners of this annotation.
Removes a listener; without fn, removes all listeners of this event.
Optionalfn: AnnotationListenerResizes to the new rectangle (use it instead of setRect when internal properties must change too; here each class's setRect already carries points / paths along, so it is setRect).
Appearance resources are all ready (our appearances are in the Worker, so always true).
The XFDF element of this annotation (such as <square .../>); asynchronous (exported by the Worker); the annotation must be added to the document first.
Sets the text contents (/Contents) of the annotation.
New contents.
Commit with updateAnnotation after changing.
Sets the attachment file: it is written to the document by a later addAnnotation (or updateAnnotation when already in the document).
OptionalmimeType: stringOptionalfilename: stringSets the file name of the attachment.
The file name.
Sets the height of the bounding box.
Height in PDF points.
Marks as changed; keepDate does not update the modification date.
Optional_keepAppearance: booleanOptional_keepSerialized: booleanOptionalkeepDate: booleanSets the point of the bounding box that stays fixed while zooming a NoZoom annotation. Values outside 0 to 1 are rejected with a warning.
x and y as fractions of the width and height (0 to 1).
Horizontal position as a fraction of the width (0 to 1).
Vertical position as a fraction of the height (0 to 1).
Sets the page the annotation is on.
The page number (1-based).
Record the origin before a pointer page transition; null resets the first-query baseline.
Geometric annotations (lines, ink, polygons, text markup) override it to move their points proportionally into the new rectangle.
Like setRect, but swaps reversed coordinates (setRect here already normalizes them, so both give the same result).
Replaces the rich text style of the contents and marks the annotation as modified.
Character position to CSS style, or null to remove the rich text style.
Sets stroke / fill / opacity of ctx for subclasses' draw().
Point-defined annotations: sets all points from viewport coordinates (points are fitted into the page). Other annotations log a warning.
New points in viewport coordinates.
X in viewport units.
Y in viewport units.
The document viewer used to convert the coordinates.
Point-defined annotations: moves one point to a position in viewport coordinates. Invalid indexes and other annotations log a warning.
Zero-based point index.
New position in viewport coordinates.
X in viewport units.
Y in viewport units.
The document viewer used to convert the coordinates.
Sets the bounding box from a viewport position, size (clamped into the page) and rotation.
Height in viewport units.
Optionalrotation?: numberRotation in degrees relative to the display orientation; defaults to 0.
Width in viewport units.
Left edge in viewport units.
Top edge in viewport units.
Sets the width of the bounding box.
Width in PDF points.
Sets the left edge of the bounding box.
X in PDF points.
Sets the top edge of the bounding box.
Y in PDF points.
Fires an event with arguments spread by position.
Optionalargs: unknown[]Like trigger, awaiting the Promise returned by each listener in turn.
Optionalargs: unknown[]Applies style to the characters in [start, end) (break points are added at both ends of the range first, then segments are merged).
Optionalstart: numberOptionalend: numberAuthor of the annotation (the /T entry).
Blend mode for drawing onto the page (canvas globalCompositeOperation name): 'multiply' multiplies with the page (text highlights, ink with intent InkHighlight); normal blending by default.
Creation date, or null when unknown.
Last modification date, or null when unknown; updated by setModified.
XFDF element name of this annotation type (such as 'square'); 'annotation' in the base class.
Fill color; null means no fill (the engine clears the fill color on commit). A color written with opacity 0 is also treated as no fill.
Height of the bounding box in PDF points.
Whether the annotation is hidden (the /F Hidden flag).
Icon name (the /Name entry), used by notes, stamps and file attachments.
Unique annotation name (the /NM entry); used to look the annotation up and to link replies and groups.
Id of the parent annotation of a reply or group.
The /F Invisible bit (1): only meaningful for unknown annotation types; use Hidden to hide annotations.
Whether the annotation was added since the last exportAnnotationCommand.
Whether parts drawn outside the rectangle can be clicked too (hit testing here only uses the rectangle; currently only the value is stored).
Deleted since the last exportAnnotationCommand (set by deleteAnnotation(s), cleared when added to the document again).
Changed since the last exportAnnotationCommand.
Whether the annotation is shown in annotation lists; defaults to true.
Whether the annotation cannot be deleted or have its properties changed (the /F Locked flag).
Whether the contents of the annotation cannot be changed (the /F LockedContents flag).
Whether resizing keeps the width-to-height ratio.
Static ReadonlyMeasurementDisplay format of measurement annotations (values of DisplayFormat).
ReadonlyDECIMAL: "Decimal"Decimal number.
ReadonlyFRACTION: "Fraction"Fraction.
ReadonlyROUND: "Round"Rounded value.
ReadonlyTRUNCATE: "Truncate"Truncated value.
Static ReadonlyMeasurementUnit system of measurement annotations (values of System).
ReadonlyIMPERIAL: "Imperial"Imperial units (in, ft, yd, mi).
ReadonlyMETRIC: "Metric"Metric units (mm, cm, m, km).
ReadonlyTYPOGRAPHIC: "Typographic"Typographic points.
Static ReadonlyMeasurementDisplay units of measurement annotations (values of DisplayUnits, Annotation.MeasurementUnits).
ReadonlyCM: "cm"Centimeters.
ReadonlyDOUBLE_PRIME_IN: "in\""Inches written with a double prime.
ReadonlyFT: "ft"Feet.
ReadonlyFT_IN: "ft-in"Feet and inches.
ReadonlyIN: "in"Inches.
ReadonlyKM: "km"Kilometers.
ReadonlyM: "m"Meters.
ReadonlyMI: "mi"Miles.
ReadonlyMM: "mm"Millimeters.
ReadonlyPRIME_FT: "ft'"Feet written with a prime.
ReadonlyPT: "pt"Points (1/72 inch).
ReadonlyYD: "yd"Yards.
Cannot be deleted: AnnotationManager deleteAnnotation(s) skips it (memory only, not written to the file).
Whether the annotation cannot be moved by the user.
Whether the annotation cannot be resized by the user.
Whether the annotation does not rotate with the page (the /F NoRotate flag).
Whether the annotation is not displayed (the /F NoView flag).
Whether the annotation keeps its size regardless of zoom (the /F NoZoom flag).
Opacity from 0 (transparent) to 1 (opaque); defaults to 1.
Page the annotation is on (1-based).
Whether the annotation is printed (the /F Print flag); defaults to true.
Whether the annotation cannot be interacted with (the /F ReadOnly flag).
'group' means a group; otherwise a reply.
Rotation of the annotation in degrees, counterclockwise.
Selection model class (a prototype property; each class's default is set in selection/model-of.ts): when selected, new selectionModel(annotation, canModify, true, docViewer) and its draw draws the selection box. Replace it with another class on a subclass prototype or a single annotation (for example one whose draw draws nothing); hit testing and handles still follow the built-in rules.
Stroke (border or line) color; defaults to black.
Stroke width in PDF points; defaults to 1.
Subject of the annotation; defaults to the subject of the annotation class.
The /F ToggleNoView bit (256).
Name of the tool that created it (written when a tool creates it, not saved to the PDF).
Width of the bounding box in PDF points.
Left edge of the bounding box in PDF points (page coordinates).
Top edge of the bounding box in PDF points (page coordinates).
Base class of all annotations. Property names start with a capital letter; changes are applied to the view immediately and committed to the document with AnnotationManager.updateAnnotation.