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'
, likeD: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'
, likeD: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 |