TextTypewriter 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. |
source |
Return the source of the annotation. |
type |
Return the type of the annotation |
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 deleted.
source
Return the source of the annotation. Possible values:
- user: the annotation is created by the user’s action
- file: the annotation is created from a PDF file
- api: the annotation is created with code
Remark
It will return ''
, if the annotation is deleted.
type
Return the type of the annotation: textTypewriter
.
All annotation types:
"rectangle" | "ellipse" | "line" | "polygon" | "polyline" | "ink" | "textBox" | "textTypewriter" | "stamp" | "highlight" | "underline" | "strikeout" | "incomplete" | "unknown"
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 deleted. - If the annotation is created but not be modified after adding, it equals to
creationDate
.
getOptions()
Get the annotation options.
Syntax
getOptions(): TextTypewriterAnnotationOptions;
Return value
The object of text typewriter annotation options. Please refer to TextTypewriterAnnotationOptions
.
Code Snippet
// Given that editViewer is an existing instance of EditViewer and a document is currently open.
const pageUid = editViewer.indexToUid(0);
const textTypewriter = Dynamsoft.DDV.annotationManager.createAnnotation(pageUid, "textTypewriter"); // Create a default TextTypewriter annotation instance.
const textTypewriterOptions = textTypewriter.getOptions();
updateOptions()
Update the annotation options.
Syntax
updateOptions(textTypewriterAnnotationOptions: TextTypewriterAnnotationOptions): boolean;
Parameters
textTypewriterAnnotationOptions
: The new text typewriter annotation options. Please refer to TextTypewriterAnnotationOptions
.
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 textTypewriter = Dynamsoft.DDV.annotationManager.createAnnotation(pageUid, "textTypewriter"); // Create a default TextTypewriter annotation instance.
const textTypewriterOptions = {
background: "red",
};
textTypewriter.updateOptions(textTypewriterOptions); // Update the background of the text typewriter 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 |