PDFTron WebViewer

Class: FreeTextAnnotation

Annotations. FreeTextAnnotation

new FreeTextAnnotation()

Represents a free text annotation.
Properties:
Name Type Description
TextColor Annotations.Color The color of the text in the annotation
Font string The font to use for the annotation's text
FontSize string The font size to use for the annotation's text, specified like a CSS font size
TextAlign string The horizontal alignment of the annotation's text (left, right, center)
EXPORT_CALCULATED_FONT_SIZE boolean Whether to export calculated font size for auto-sized fonts (default is true)
autoSizeProperties object Object that contains all the flags to customize the auto-sizing behavior
Properties
Name Type Description
shrinkWidth boolean Whether to shrink the width of the annotation if the size of its contents are smaller in width than the annotation
shrinkHeight boolean Whether to shrink the height of the annotation if the size of its contents are smaller in height than the annotation
expandWidth boolean Whether to expand the width of the annotation if the size of the contents are larger in width than the annotation
expandHeight boolean Whether to expand the height of the annotation if the size of the contents are larger in height than the annotation

Extends

Classes

Editor

Methods

addCustomAppearance(doc [, options])

Adds a custom appearance to the annotation so that the annotation appears like the specified PDF page or object in the PDF page. This appearance will be used instead of the default WebViewer drawing of the annotation.
Parameters:
Name Type Argument Description
doc CoreControls.Document the PDF document object.
options object <optional>
 An object that can contain the following optional parameters.
Properties
Name Type Argument Default Description
pageNumber string <optional>
 1 Page number of source document to use for custom appearance.
objnum string <optional>
 The object number from the appearance document.
gennum string <optional>
 The generation number from the appearance document.
transparentBackground string <optional>
 Transparent background, default is true.
Inherited From:

addPathPoint(x, y)

Adds a point to the path
Parameters:
Name Type Description
x number The x coordinate of the point
y number The y coordinate of the point
Inherited From:

adjustRect()

Recalculate the width and height of the annotation
Inherited From:
Associate a link with annotation. The associated links will be deleted with the annotation. You can associate multiple links with a single annotation.
Parameters:
Name Type Description
linkIds Array.<string> | string The link IDs to associate with the current annotation.
Inherited From:

deleteCustomData(key)

Deletes custom data associated with the given key.
Parameters:
Name Type Description
key string The key for which to delete the associated data.
Inherited From:

deserialize(element, pageMatrix)

Deserializes the xml element into the annotation
Parameters:
Name Type Description
element Element an xml element representing the annotation
pageMatrix object the page matrix used to convert PDF coordinates to XOD coordinates.
Inherited From:

disableEnterKeypress()

Disables the Enter key for the instance of RichTextEditor

draw(ctx, pageMatrix)

Draws the annotation on the provide canvas context, relative to the page. The point (0,0) coresponds to the top left corner of the page.
Parameters:
Name Type Description
ctx CanvasRenderingContext2D The canvas context prepared to be drawn on.
pageMatrix object The page matrix for the page that the annotation is on. You can get this object by calling getPageMatrix on the document object.
Inherited From:

enableEnterKeypress()

Enables the Enter key for the instance of RichTextEditor

fitText(pageInfo, pageMatrix, pageRotation)

Resize the annotation's text box to fit its contents
Parameters:
Name Type Description
pageInfo CoreControls.Document.PageInfo An object representing the page info. Contains the properties "width" and "height".
pageMatrix object The transformation matrix for the page that the annotation is on.
pageRotation number The internal degrees of rotation of the current page.
Example
const freetextAnnot = annotManager.getAnnotationsList()[0];
const doc = docViewer.getDocument();
const pageNumber = 1;
const pageInfo = doc.getPageInfo(pageNumber);
const pageMatrix = doc.getPageMatrix(pageNumber);
const pageRotation = doc.getPageRotation(pageNumber);
freetextAnnot.fitText(pageInfo, pageMatrix, pageRotation);
annotManager.drawAnnotationsFromList([freetextAnnot]);
Returns all associated links with the annotation.
Inherited From:
Returns:
Link IDs associated with the annotation.
Type
Array.<string>

getBottom()

Gets the bottommost y position measured in page coordinates.
Inherited From:
Deprecated:
  • Since 1.7
Returns:
Type
number

getContents()

Gets the text content for the annotation. Contents may be displayed in an annotation's popup or directly on the page (in the case of FreeTextAnnotation).
Inherited From:
Returns:
the text content for the annotation.
Type
string

getCustomData(key)

Returns custom data associated with the given key.
Parameters:
Name Type Description
key string The key for which to retrieve the associated data.
Inherited From:
Returns:
value The custom data. If no data is available an empty string is returned.
Type
*

getEditor()

Returns:
Returns the rich text editor instance associated with the annotation
Type
Annotations.FreeTextAnnotation.Editor

getGroupedChildren()

Gets the list of group children to this annotation.
Inherited From:
Returns:
The list of group children
Type
Array.<Annotations.Annotation>

getHeight()

Gets the height of the annotation.
Inherited From:
Returns:
the height of the annotation.
Type
number

getIntent()

Gets the intent of the FreeText annotation e.g. FreeTextCallout
Returns:
The intent of the annotation
Type
string

getInternal()

Returns true if annotation is part of the original document, false otherwise.
Inherited From:
Returns:
Whether the annotation is internal to the document or not
Type
boolean

getLeft()

Gets the leftmost x position measured in page coordinates.
Inherited From:
Deprecated:
  • Since 1.7
Returns:
Type
number

getPadding()

Get the rectangle difference of the annotation bounding rect and the text rect
Returns:
the rectangle difference
Type
CoreControls.Math.Rect

getPageNumber()

Gets the page number of the annotation. Note: page number starts from 1.
Inherited From:
Returns:
The annotation's page number
Type
number

getPath()

Gets the path array
Inherited From:
Returns:
The array of path points
Type
Array.<CoreControls.Math.Point>

getPathPoint(index)

Gets the point in the path at the specified index
Parameters:
Name Type Description
index number The index in the path array
Inherited From:
Returns:
The path point as an object with x and y properties
Type
object

getRect()

Get annotation bounding rectangle
Inherited From:
Returns:
Type
CoreControls.Math.Rect

getRectPadding()

Gets the padding that will be applied by default on the annotation's rectangle.
Inherited From:
Returns:
The amount of padding
Type
number

getReplies()

Gets the list of replies to this annotation.
Inherited From:
Returns:
The list of replies
Type
Array.<Annotations.Annotation>

getRichTextStyle()

Gets the rich text style of the annotation.
Inherited From:
Returns:
the current rich text style
Type
Annotations.Annotation.RichTextStyle

getRight()

Gets the rightmost x position measured in page coordinates.
Inherited From:
Deprecated:
  • Since 1.7
Returns:
Type
number

getStartStyle()

Gets the start style of the line. Only applicable for callout annotations
Returns:
The start style
Type
string

getStatus()

Gets the status of the annotation, and returns an empty string if no status set.
Inherited From:
Returns:
The last status update.
Type
string

getTop()

Gets the topmost y position measured in page coordinates.
Inherited From:
Deprecated:
  • Since 1.7
Returns:
Type
number

getWidth()

Gets the width of the annotation.
Inherited From:
Returns:
the width of the annotation.
Type
number

getX()

Gets the x position measured in page coordinates of an annotation.
Inherited From:
Returns:
the x position
Type
number

getY()

Gets the y position measured in page coordinates.
Inherited From:
Returns:
Type
number

hasRotationControlEnabled()

Returns true if the rotation control is enabled for the annotation and false otherwise.
Inherited From:
Returns:
Type
boolean

isAutoSized()

Returns:
Returns a boolean which indicates if the bounding box of the freetext will be resized automatically when its contents are being edited
Type
boolean

isGrouped()

Gets whether the annotation is a child of a group
Inherited From:
Returns:
Returns true if the annotation is a child of a group, false otherwise.
Type
boolean

isPrintVisible()

Whether the annotation is visible on the document or not **when printed**. If Hidden or if the annotation is a reply to another annotation then it won't be visible.
Inherited From:
Returns:
Whether the annotation is visible on the document or not when printed
Type
boolean

isReply()

Gets whether the annotation is a reply to another annotation.
Inherited From:
Returns:
Returns true if it does reply to another annotation, false otherwise.
Type
boolean

isVisible()

Whether the annotation is visible on the document or not **when viewing**. If the Hidden or NoView flags are set, or if the annotation is a reply to another annotation then it won't be visible.
Inherited From:
Returns:
Whether the annotation is visible on the document or not when viewing
Type
boolean

popPath()

Removes the last point from the path
Inherited From:

removeCustomAppearance()

Removes the custom appearance of the annotation.
Inherited From:

resize(rect)

Resize the annotation based on a new given CoreControls.Math.Rect. Use this method instead of setRect when internal properties (other than x, y, width and height) need to be modified on move/resize.
Parameters:
Name Type Description
rect CoreControls.Math.Rect the new bounding rectangle
Inherited From:

resourcesLoaded()

Resolves when all required resources have finished loading. Currently only applicable to stamp annotations that use images.
Inherited From:
Returns:
A promise that resolves when the resources have finished loading
Type
Promise.<any>

rotate(angle, rotationPoint)

Rotate the annotation by angle and origin point to rotate around.
Parameters:
Name Type Description
angle number The angle in radians
rotationPoint CoreControls.Math.Point The rotation point to do the rotation around. The default is the center point of the annotation
Inherited From:

serialize(element, pageMatrix)

Serialize the annotation to an xml element
Parameters:
Name Type Description
element Element an xml element representing the annotation
pageMatrix object the page matrix used to convert XOD coordinates to PDF coordinates.
Inherited From:
Returns:
the resulting xml element representing the annotation
Type
Element

setContents(value)

Set the text content for the annotation. Note that this will not refresh the text in the UI.
Parameters:
Name Type Description
value string the text content to be set
Inherited From:

setCustomData(key, value)

Sets the custom data associated with the specified key.
Parameters:
Name Type Description
key string The key under which to store this custom data. Data will automatically be saved in the exported XFDF and merged into the PDF when downloading.
value * The custom data to store
Inherited From:

setHeight(value)

Sets the height of the annotation.
Parameters:
Name Type Description
value number the height of the annotation.
Inherited From:

setIntent(intent)

Sets the intent of the FreeText annotation
Parameters:
Name Type Description
intent string The new intent for the annotation

setModified( [keepAppearance])

Flags the annotation as modified if it has been before the last call to exportAnnotCommand Removes the annotation's appearance if no parameter is passed Should be called if changing a custom property on the annotation that is used for serialization Otherwise the annotation will serialize the original deserialized value
Parameters:
Name Type Argument Description
keepAppearance boolean <optional>
 If true then the annotation's appearance will be maintained
Inherited From:

setPadding(rect)

Sets the rectangle difference of the annotation bounding rect and the text rect
Parameters:
Name Type Description
rect CoreControls.Math.Rect The new rectangle difference

setPageNumber(value)

Sets the page number of the annotation. Note: page numbers start from 1.
Parameters:
Name Type Description
value number the page number to be set
Inherited From:

setPathPoint(index, x, y)

Sets the path point at a specific index
Parameters:
Name Type Description
index number The index in the path array to set
x number The x coordinate of the point
y number The y coordinate of the point
Inherited From:

setRect(rect)

Sets the size and location of the annotation's bounding rectangle. Use this method instead of resize when only the x, y, width and height needs to be modified. Beware: this method ignores coordinates if they are the wrong way around. (It hasn't been fixed for reasons of maintaining backward compatibility. use setRectWithNormalization instead if you want it to reverse the wrong-way-round coordinates instead of ignoring them.)
Parameters:
Name Type Description
rect CoreControls.Math.Rect the new bounding rectangle
Inherited From:

setRectWithNormalization(rect)

Sets the size and location of the annotation's bounding rectangle. Use this method instead of resize when only the x, y, width and height needs to be modified. Use setRectWithNormalization instead of setRect if you want to reverse any wrong-way-round coordinates instead of ignoring them.
Parameters:
Name Type Description
rect CoreControls.Math.Rect the new bounding rectangle
Inherited From:

setRichTextStyle(richTextStyle)

Sets the rich text style of the annotation.
Parameters:
Name Type Description
richTextStyle Annotations.Annotation.RichTextStyle The new rich text style of the annotation
Inherited From:

setRotationControlEnabled(rotationControlEnabled)

Enables or disables the rotation control for the annotation
Parameters:
Name Type Description
rotationControlEnabled boolean true if the rotation control should be enabled
Inherited From:

setStartStyle(startStyle)

Sets the start style of the line. Only applicable for callout annotations.
Parameters:
Name Type Description
startStyle string The starting style

setStyles(ctx, pageMatrix)

Sets the annotation's styles for stroke, fill and opacity on the canvas context
Parameters:
Name Type Description
ctx CanvasRenderingContext2D A canvas context
pageMatrix object The transformation matrix for the page that the annotation is on
Inherited From:

setWidth(value)

Sets the width of the annotation.
Parameters:
Name Type Description
value number the width of the annotation.
Inherited From:

setX(value)

Sets the x position measured in page coordinates of an annotation.
Parameters:
Name Type Description
value number the x position
Inherited From:

setY(value)

Sets the y position measured in page coordinates.
Parameters:
Name Type Description
value number the y position
Inherited From:
Removes all associated links with the annotation. Doesn't remove the underlying links.
Inherited From: