PDF annot object. More...

Inheritance diagram for Annot:

Public Member Functions
	exportToJSON ()
	Export the current annotation to a Json object. [Support in Server] More...

	getBorderColor ()
	Get annotation's border color. [Support in Server] More...

	getBorderInfo ()
	Get annotation's border information. [Support in Server] More...

	getContent ()
	Get annotation's contents. [Support in Server] More...

	getDictionaryEntry (key)
	Get the dictionary property of Annot by key. More...

	getFlags ()
	Get annotation's flag. [Support in Server] More...

	getModifiedDateTime ()
	Get annotation's last modified date time. [Support in Server] More...

	getObjectNumber ()
	Get annotation's object number. More...

	getPage ()
	Get annotation's page. [Support in Server] More...

	getRect ()
	Get annotation's rect. [Support in Server] More...

	getTitle ()
	Get annotation's title. [Support in Server] More...

	getType ()
	Get annotation's type. [Support in Server] More...

	getUniqueID ()
	Get annotation's unique ID. [Support in Server] More...

	isEmpty ()
	Check annotation is empty or not. [Support in Server] More...

	isMarkup ()
	Check if current annotation is a markup annotation. [Support in Server] More...

	setBorderColor (borderColor)
	Set annotation's border color. [Support in Server] More...

	setBorderInfo (borderInfo)
	Set annotation's border information. [Support in Server] More...

	setContent (content)
	Set contents for the currently gotten annotation. [Support in Server] More...

	setCustomAPStream (appearanceType, appearanceStream)

	setDictionaryEntry (key, value)
	Add a new entry or replace the existing entry of the annotation dictionary. Caller could use this method to store their private data to the annotation. Do not use any standard key of the annotation dictionary, such as 'Type', 'Subtype', 'Rect' defined in PDF Reference. If any standard key is used, this behaviour will be undefined. More...

	setFlags (flag, notTriggerEvent)
	Set annotation's flag. [Support in Server] More...

	setModifiedDateTime (date)
	Set annotation's last modified date time. [Support in Server] More...

	setRect (rect)
	Set annotation's rect. More...

Detailed Description

PDF annot object.

Member Function Documentation

◆ exportToJSON()

Annot::exportToJSON ( )

inline

Export the current annotation to a Json object. [Support in Server]

Returns: object - A json object of annotation's property. The key and value formats try to follow XFDF specifications

Note: Binary data will not be exported with this function. Use PDFDoc::exportAnnotsToJSON instead.
{
type: string,
color: string,
flags: string,
date:string,//{D:20190321150656+08'00'}
name: string,
page: number,
rect: string,
contents: string,
width: borderWidth,
customEntries:object // Custom data
}

◆ getBorderColor()

Annot::getBorderColor ( )

inline

Get annotation's border color. [Support in Server]

Returns: number - An integer indicating border color will be returned. Format: 0xRRGGBB.

◆ getBorderInfo()

Annot::getBorderInfo ( )

inline

Get annotation's border information. [Support in Server]

Returns: {cloudIntensity:number, dashPhase: number, dashes: number[], style: number, width: number} -
{
cloudIntensity:{number},//Intensity of the cloudy effect, only 0~2 is valid.
dashPhase:{number},//Dash phase.
dashes:Array[number],//A dash array that represents the dash patterns. It's valid when border style is dashed.
style:{number},//Please refer to {@link Border_Style} for details.
width:{numner}
}

◆ getContent()

Annot::getContent ( )

inline

Get annotation's contents. [Support in Server]

Returns: string - Annotation's contents will be returned.

◆ getDictionaryEntry()

Annot::getDictionaryEntry ( key )

inline

Get the dictionary property of Annot by key.

Parameters

key	string - The key of the entry, whose value element will be get. It should not be an empty string. function example(annot){ annot.getDictionaryEntry("*") }

Since: 7.5.0

Returns: Promise<string> - A string indicates annotation's key

◆ getFlags()

Annot::getFlags ( )

inline

Get annotation's flag. [Support in Server]

Returns: number - Annotation flag number.

See also: Annot_Flags

◆ getModifiedDateTime()

Annot::getModifiedDateTime ( )

inline

Get annotation's last modified date time. [Support in Server]

Returns: Date|null - A Date object, If there is no modified date time information, null would be returned

◆ getObjectNumber()

Annot::getObjectNumber ( )

inline

Get annotation's object number.

Returns: number - A number indicates annotation's object number.

Since: 8.1.0

◆ getPage()

Annot::getPage ( )

inline

Get annotation's page. [Support in Server]

Returns: PDFPage - PDF page object.

◆ getRect()

Annot::getRect ( )

inline

Get annotation's rect. [Support in Server]

Returns: PDFRect - A PDF rectangle.
{
left:{number},
top:{number},
right:{number},
bottom:{number}
}

◆ getTitle()

Annot::getTitle ( )

inline

Get annotation's title. [Support in Server]

Returns: string - A string indicates annotation's title.

◆ getType()

Annot::getType ( )

inline

Get annotation's type. [Support in Server]

Returns: string - A string indicates annotation's type.

See also: Annot_Type

◆ getUniqueID()

Annot::getUniqueID ( )

inline

Get annotation's unique ID. [Support in Server]

Returns: string - A string indicates annotation's unique ID.

◆ isEmpty()

Annot::isEmpty ( )

inline

Check annotation is empty or not. [Support in Server]

Returns: boolean - Annotation is empty or not

◆ isMarkup()

Annot::isMarkup ( )

inline

Check if current annotation is a markup annotation. [Support in Server]

Returns: boolean - true means current annotation is a markup annotation, while false means current annotation is not a markup annotation.

◆ setBorderColor()

Annot::setBorderColor ( borderColor )

inline

Set annotation's border color. [Support in Server]

Parameters

borderColor

number|[string,number,number,number]|string - Specify border color (alpha is not supported). Supported color format:

number, such as 0xff0000, 16711680
PDF color array, such as ['RGB',1,1,1] which means white. Range: 0.0~1.0, The ratio to HTML color format is 1:255.
HTML color format, such as '#ff0000', 'rgb(255,0,0)', 'rgba(255,0,0,1)'

Returns: Promise<boolean> - A boolean value indicating whether success.

◆ setBorderInfo()

Annot::setBorderInfo ( borderInfo )

inline

Set annotation's border information. [Support in Server]

Note: The cloudy segments are only honored by polygon, square and circle. If the cloud style was applied to others like text markup, caret, stamp, ink and note, no effect will be drawn.

Parameters

borderInfo	object - Border infomation.
[borderInfo.cloudIntensity]	number - Cloud intensity, Valid value range: 0 to 2. 0 means no cloudy border effect. If the value is below 0, it will have the same effect as value 0. If the value is above 2, it will have the same effect as value 2.
[borderInfo.dashPhase]	number - Dash phase.
[borderInfo.dashes]	number[] - Dashes array.
borderInfo.style	Border_Style - Border style, only Border_Style.solid, Border_Style.dashed Border_Style.cloudy and Border_Style.noBorder are supported.
borderInfo.width	number - Border width. interface BorderInfo { cloudIntensity: number,//Intensity of the cloudy effect, only 0,1 and 2 is valid. dashPhase:number,//Dash phase. dashes:number[],//A dash array that represents the dash patterns. style:number, width:number, // unsigned integer. }

Returns: Promise<void>

◆ setContent()

Annot::setContent ( content )

inline

Set contents for the currently gotten annotation. [Support in Server]

Parameters

content string - New contents to be setted.

Returns: Promise<Annot[]|Annot> - Annotations modified will be returned.

◆ setCustomAPStream()

Annot::setCustomAPStream	(	appearanceType,
		appearanceStream
	)

inline

Set the customized appearance stream for the annotation.

Parameters

appearanceType	string - The type of annotation's appearance. It should be one of the following values: 'normal' - Annotation's normal appearance. 'rollover' - Annotation's rollover appearance. 'down' - Annotation's down appearance.
appearanceStream	string - The customized appearance stream.

Since: 10.0.0

◆ setDictionaryEntry()

Annot::setDictionaryEntry	(	key,
		value
	)

inline

Add a new entry or replace the existing entry of the annotation dictionary. Caller could use this method to store their private data to the annotation. Do not use any standard key of the annotation dictionary, such as 'Type', 'Subtype', 'Rect' defined in PDF Reference. If any standard key is used, this behaviour will be undefined.

Parameters

key	string - The key of the entry, whose value element will be set. It should not be an empty string.
value	string - A wide string which will be set as PDF string object to the entry. function example(annot){ annot.setDictionaryEntry("","") }

Since: 7.5.0

Returns: Promise<boolean> - A boolean value indicates success or failure

◆ setFlags()

Annot::setFlags	(	flag,
		notTriggerEvent
	)

inline

Set annotation's flag. [Support in Server]

Parameters

flag	number - An Annot_Flags number indicating annotation's flag.

Returns: Promise<boolean> - A boolean value indicating the success or failue.

See also: Annot_Flags

◆ setModifiedDateTime()

Annot::setModifiedDateTime ( date )

inline

Set annotation's last modified date time. [Support in Server]

Parameters

date	Date\|number - A Date object or an integer indicating million secounds from 1970.1.1 00:00:00.

Returns: Promise<boolean>

◆ setRect()

Annot::setRect ( rect )

inline

Set annotation's rect.

Note: The paging seal signature is not supported. Please use PDFDoc.updatePagingSealInfo

Parameters

rect	PDFRect - Rectangle to be setted.

Returns: Promise<boolean> - true for success, otherwise failure.

Since: 8.5.0

Public Member Functions

Detailed Description

Member Function Documentation

◆ exportToJSON()

◆ getBorderColor()

◆ getBorderInfo()

◆ getContent()

◆ getDictionaryEntry()

◆ getFlags()

◆ getModifiedDateTime()

◆ getObjectNumber()

◆ getPage()

◆ getRect()

◆ getTitle()

◆ getType()

◆ getUniqueID()

◆ isEmpty()

◆ isMarkup()

◆ setBorderColor()

◆ setBorderInfo()

◆ setContent()

◆ setCustomAPStream()

◆ setDictionaryEntry()

◆ setFlags()

◆ setModifiedDateTime()

◆ setRect()