Resource Base
Table of contents

Ink Class

API Index

API Name Description
uid Return the uid of the annotation.
pageUid Return the uid of the page where the annotation is located.
creationDate Return the creation date of the annotation.
flattened Flattens the annotation onto the image layer, or inspect if the annotation is flattened.
modificationDate Return the modification date of the annotation.
getOptions() Get the annotation options.
updateOptions() Update the annotation options.

uid

Return the uid of the annotation.

Syntax

readonly uid: string;

pageUid

Return the uid of the page where the annotation is located.

Syntax

readonly pageUid: string;

Remark

  • It will return '', if the annotation is be deleted.

creationDate

Return the creation date of the annotation.

Syntax

readonly creationDate: string;

Remark

  • The string would be D:YYYYMMDDHHmmSSOHH'mm', like D:20230101085959-08'00'.

flattened

Flattens the annotation onto the image layer, or inspect if the annotation is flattened.

Syntax

flattened: boolean;  //Default value is `false`.

Remark

Flattened annotations move below all unflattened annotations on the page, and are stacked amongst themselves accordingly.

Flattened annotations become part of the page layer upon file export and cease to be annotations.

modificationDate

Return the modification date of the annotation.

Syntax

readonly modificationDate: string;

Remark

  • The string would be D:YYYYMMDDHHmmSSOHH'mm', like D:20230101085959-08'00'.
  • It will return '', if the annotation is be deleted.
  • If the annotation is created but not be modified after adding, it equals to creationDate.

getOptions()

Get the annotation options.

Syntax

getOptions(): InkAnnotationOptions;

Return value

The object of ink annotation options. Please refer to InkAnnotationOptions.

Code Snippet

// Given that editViewer is an existing instance of EditViewer and a document is currently open.
const pageUid = editViewer.indexToUid(0);
const ink = Dynamsoft.DDV.annotationManager.createAnnotation(pageUid, "ink"); // Create a default Ink annotation instance.
const inkOptions = ink.getOptions();

updateOptions()

Update the annotation options.

Syntax

updateOptions(inkAnnotationOptions: InkAnnotationOptions): boolean;

Parameters

inkAnnotationOptions: The new ink annotation options. Please refer to InkAnnotationOptions.

Return value

true: Successfully.

false: Failed.

Code Snippet

// Given that editViewer is an existing instance of EditViewer and a document is currently open.
const pageUid = editViewer.indexToUid(0);
const ink = Dynamsoft.DDV.annotationManager.createAnnotation(pageUid,  "ink"); // Create a default Ink annotation instance.
const inkOptions = {
    borderColor: "red",
};
ink.updateOptions(inkOptions); // Update the border color of the ink to red.

Warning

Error Code Error Message API Return Value
-80100 XXX(API): XXX(ParameterName) is invalid. false
-80102 XXX(API): XXX(ParameterName) is missing. false

This page is compatible for:

Is this page helpful?

YesYes NoNo

In this article: