[]
DsPdfJS API / PopupAnnotation
Reprensets an annotation displays text in a popup window for entry and editing. It shall not appear alone but is associated with a MarkupAnnotation, its parent annotation, and shall be used for editing the parent's text.
new PopupAnnotation(
om):PopupAnnotation
Creates a new PopupAnnotation.
ObjectManager that controls the lifetime of the PopupAnnotation.
PopupAnnotation
AnnotationBase.constructor
new PopupAnnotation():
PopupAnnotation
Creates a new PopupAnnotation.
PopupAnnotation
AnnotationBase.constructor
get color():
Color
Gets or sets the popup window color.
set color(
value):void
Gets or sets the popup window color.
void
get contents():
string|null
Gets or sets the text to be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation's contents in human-readable form. In either case, this text is useful when extracting the document's contents in support of accessibility to users with disabilities or for other purposes.
string | null
set contents(
value):void
Gets or sets the text to be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation's contents in human-readable form. In either case, this text is useful when extracting the document's contents in support of accessibility to users with disabilities or for other purposes.
string | null
void
get doc():
PdfDocument|null
Gets the PdfDocument owning this annotation.
PdfDocument | null
get flags():
AnnotationFlags
Gets or sets the flags specifying various characteristics of the annotation.
set flags(
value):void
Gets or sets the flags specifying various characteristics of the annotation.
void
get id():
number
Gets the reference to the object.
number
get locked():
boolean
Gets or sets a value indicating whether the annotation can be deleted or its properties (including position and size) can be modified by the user. However, this flag does not restrict changes to the annotation's contents, such as the value of a form field.
boolean
set locked(
value):void
Gets or sets a value indicating whether the annotation can be deleted or its properties (including position and size) can be modified by the user. However, this flag does not restrict changes to the annotation's contents, such as the value of a form field.
boolean
void
get lockedContents():
boolean
Gets or sets a value indicating whether the contents of the annotation can be modified by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties, such as position and size.
boolean
set lockedContents(
value):void
Gets or sets a value indicating whether the contents of the annotation can be modified by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties, such as position and size.
boolean
void
get modifiedDate():
PdfDateTime|null
Gets or sets the date and time when the annotation was modified.
PdfDateTime | null
set modifiedDate(
value):void
Gets or sets the date and time when the annotation was modified.
PdfDateTime | null
void
get name():
string|null
Gets or sets the annotation name, a text string uniquely identifying it among all annotations on its page.
string | null
set name(
value):void
Gets or sets the annotation name, a text string uniquely identifying it among all annotations on its page.
string | null
void
get om():
ObjectManager
Gets the owner ObjectManager instance.
get open():
boolean
Gets or sets a value specifying whether the pop-up annotation should initially be displayed open.
boolean
set open(
value):void
Gets or sets a value specifying whether the pop-up annotation should initially be displayed open.
boolean
void
get page():
PdfPage|null
Gets or sets the PdfPage that contains this annotation. Note that an annotation may be referenced by several pages. In that case this property returns the first element in the pages collection. When setting this property, the following applies: If the new value is null, this annotation is removed from all pages. Otherwise, this annotation is assigned exclusively to the specified page.
PdfPage | null
set page(
value):void
Gets or sets the PdfPage that contains this annotation. Note that an annotation may be referenced by several pages. In that case this property returns the first element in the pages collection. When setting this property, the following applies: If the new value is null, this annotation is removed from all pages. Otherwise, this annotation is assigned exclusively to the specified page.
PdfPage | null
void
get pages():
AnnotationPagesCollection
Gets the list of pages that reference this annotation.
get parent():
MarkupAnnotation|null
Gets the parent MarkupAnnotation of the current annotation. This property changes when the MarkupAnnotation#referenceAnnotation is changed.
MarkupAnnotation | null
get pdfRect():
Rect
Gets or sets the rectangle that defines the location and size of the annotation on a page in PDF user space coordinates. The positive X axis extends horizontally to the right, and the positive Y axis extends vertically upward, with the origin usually in the lower left corner of the page.
set pdfRect(
value):void
Gets or sets the rectangle that defines the location and size of the annotation on a page in PDF user space coordinates. The positive X axis extends horizontally to the right, and the positive Y axis extends vertically upward, with the origin usually in the lower left corner of the page.
void
get rect():
Rect
Gets or sets the rectangle that defines the location and size of the annotation on a page. The coordinates of the rectangle are relative to the upper left corner of the page's media box, with the Y (vertical) coordinates increasing from top to bottom. Note that if the annotation is associated with more than one page, the media box of the first of those pages is used to calculate the rectangle's location.
set rect(
value):void
Gets or sets the rectangle that defines the location and size of the annotation on a page. The coordinates of the rectangle are relative to the upper left corner of the page's media box, with the Y (vertical) coordinates increasing from top to bottom. Note that if the annotation is associated with more than one page, the media box of the first of those pages is used to calculate the rectangle's location.
void
free():
void
Detaches the object from the ObjectManager and deallocates its memory, if possible.
void
rebind(
omTo):void
Rebinds the object from the current ObjectManager to the specified one.
The new ObjectManager for the object.
void
removeAppearance():
void
Removes all appearance streams associated with the current annotation, and disables generation of appearance steams for this annotation when the document is saved.
Note that if any property affecting the annotation's appearance 'rect' is then changed, the appearance streams will be regenerated. So this method would usually be called after initializing all annotation's properties.
void
AnnotationBase.removeAppearance
resetAppearance():
void
Forces regeneration of the annotation's appearance streams next time the document is saved.
void