-
Classes
- AcroForm
- ActionBase
- ActionFieldsBase
- ActionGoTo
- ActionGoToR
- ActionHide
- ActionImportData
- ActionJavaScript
- ActionJavaScriptMap
- ActionLaunch
- ActionLaunchWinAttrs
- ActionNamed
- ActionResetForm
- ActionSound
- ActionSubmitForm
- ActionUnknown
- ActionUri
- AnnotationBase
- AnnotationCollection
- AnnotationPagesCollection
- AppearanceStream
- AppearanceStreams
- AssociatedFiles
- Attr
- AttrClsRevision
- AttrClsRevisionCollection
- AttrCollection
- AttrRevision
- AttrRevisionCollection
- BilevelBitmap
- Bitmap
- BmpContext
- Border
- BorderEffect
- Brush
- ButtonAppearance
- CaretAnnotation
- CheckBoxField
- ChoiceField
- CircleAnnotation
- ClassMap
- ComboBoxField
- CombTextField
- ContentItemLink
- ContentItemLinkCollection
- DefaultAppearance
- Destination
- DestinationBase
- DestinationFit
- DestinationFitB
- DestinationFitBh
- DestinationFitBv
- DestinationFitH
- DestinationFitR
- DestinationFitV
- DestinationRef
- DestinationUnknown
- DestinationXyz
- DocAction
- DocumentDestinations
- DocumentInfo
- DocumentSecurityStore
- DrawingContext
- DsPdf
- DsPdfConfig
- EmbeddedFileStream
- Field
- FieldCollection
- FieldWidgetCollection
- FileAttachmentAnnotation
- FileInfo
- FileSpecification
- FileSpecificationMap
- Font
- FontCollection
- FontHandler
- FontHandlerCollection
- Format
- FormXObject
- FreeTextAnnotation
- GraphicsPath
- GrayscaleBitmap
- HatchBrush
- IccProfile
- Image
- ImageBrush
- InkAnnotation
- Layout
- LineAnnotation
- LinearGradientBrush
- LinkAnnotation
- ListBoxField
- MarkInfo
- MarkupAnnotation
- McidContentItemLink
- McrContentItemLink
- Metadata
- Model3DAnnotation
- Model3DStream
- Model3DView
- Model3DViewCollection
- Namespace
- NamespaceCollection
- ObjectBase
- ObjectManager
- ObjrContentItemLink
- OutlineNode
- OutlineNodeCollection
- OutputIntent
- OutputIntentCollection
- PageLabelingRange
- PageLabelingRangeMap
- PdfCidFont
- PdfCidFontType0
- PdfCidFontType2
- PdfCidFontUnknown
- PdfCMapTable
- PdfContext
- PdfDocument
- PdfFont
- PdfFontDescriptor
- PdfFontSimple
- PdfFontTrueType
- PdfFontType0
- PdfFontType1
- PdfFontType3
- PdfImageHandler
- PdfImageHandlerCollection
- PdfPage
- PdfPageCollection
- PdfSignature
- Pen
- Pkcs7Signer
- Pkcs7SignerBase
- PolygonAnnotation
- PolygonAnnotationBase
- PolyLineAnnotation
- PopupAnnotation
- PushButtonField
- RadialGradientBrush
- RadioButtonField
- RContentItemLink
- RedactAnnotation
- RichMediaAnnotation
- RoleMap
- Security
- SecurityHandlerBase
- SignatureField
- SolidBrush
- SoundAnnotation
- SoundObject
- SplitOptions
- SquareAnnotation
- StampAnnotation
- StandardSecurityHandler
- StandardSecurityHandlerRev2
- StandardSecurityHandlerRev3
- StandardSecurityHandlerRev4
- StandardSecurityHandlerRev5
- StandardSecurityHandlerRev6
- StructElement
- StructElementCollection
- StructTreeItem
- StructTreeItemCollection
- StructTreeRoot
- SvgContext
- SvgDocument
- TextAnnotation
- TextField
- TextMarkupAnnotation
- TimeStamper
- TimeStampProvider
- Transform
- UnknownAnnotation
- UnknownSecurityHandler
- WatermarkAnnotation
- WidgetAnnotation
- Enumerations
- Functions
- Interfaces
- README
- Index
- TypeAliases
- Variables
WidgetAnnotation
Class: WidgetAnnotation
Represents a widget annotation used in interactive forms to represent the appearance of fields and to manage user interactions.
Extends
Constructors
Constructor
new WidgetAnnotation(om): WidgetAnnotation;
Creates a new WidgetAnnotation.
Parameters
om
ObjectManager that controls the lifetime of the WidgetAnnotation.
Returns
WidgetAnnotation
Overrides
AnnotationBase.constructor
Constructor
new WidgetAnnotation(): WidgetAnnotation;
Creates a new WidgetAnnotation.
Returns
WidgetAnnotation
Overrides
AnnotationBase.constructor
Accessors
activate
Get Signature
get activate(): ActionBase;
Gets or sets an action to be performed when the annotation is activated.
Returns
Set Signature
set activate(value): void;
Gets or sets an action to be performed when the annotation is activated.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
annotationPageClosed
Get Signature
get annotationPageClosed(): ActionBase;
Gets or sets an action to be performed when the page containing the annotation is closed (for example, when the user navigates to the next or previous page, or follows a link annotation or outline item).
Returns
Set Signature
set annotationPageClosed(value): void;
Gets or sets an action to be performed when the page containing the annotation is closed (for example, when the user navigates to the next or previous page, or follows a link annotation or outline item).
Parameters
value
| ActionProperties
| ActionBase
Returns
void
annotationPageHide
Get Signature
get annotationPageHide(): ActionBase;
Gets or sets an action to be performed when the page containing the annotation is no longer visible in the viewer application's user interface.
Returns
Set Signature
set annotationPageHide(value): void;
Gets or sets an action to be performed when the page containing the annotation is no longer visible in the viewer application's user interface.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
annotationPageOpened
Get Signature
get annotationPageOpened(): ActionBase;
Gets or sets an action to be performed when the page containing the annotation is opened (for example, when the user navigates to it from the next or previous page or by means of a link annotation or outline item).
Returns
Set Signature
set annotationPageOpened(value): void;
Gets or sets an action to be performed when the page containing the annotation is opened (for example, when the user navigates to it from the next or previous page or by means of a link annotation or outline item).
Parameters
value
| ActionProperties
| ActionBase
Returns
void
annotationPageShow
Get Signature
get annotationPageShow(): ActionBase;
Gets or sets an action to be performed when the page containing the annotation becomes visible in the viewer application's user interface.
Returns
Set Signature
set annotationPageShow(value): void;
Gets or sets an action to be performed when the page containing the annotation becomes visible in the viewer application's user interface.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
appearanceStreams
Get Signature
get appearanceStreams(): AppearanceStreams;
Gets the AppearanceStreams object providing access to the annotation's appearance streams.
Returns
Inherited from
AnnotationBase.appearanceStreams
associatedFiles
Get Signature
get associatedFiles(): AssociatedFiles;
Gets the list of embedded files associated with this annotation.
Returns
Inherited from
AnnotationBase.associatedFiles
backColor
Get Signature
get backColor(): Color;
Gets or sets the annotation's background color.
Returns
Set Signature
set backColor(value): void;
Gets or sets the annotation's background color.
Parameters
value
Returns
void
border
Get Signature
get border(): Border;
Gets or sets the annotation border.
Returns
Set Signature
set border(value): void;
Gets or sets the annotation border.
Parameters
value
Returns
void
buttonAppearance
Get Signature
get buttonAppearance(): ButtonAppearance;
Gets the ButtonAppearance object that specifies the look of the widget if it is linked with a push button field.
Returns
checkStyle
Get Signature
get checkStyle(): CheckStyle;
Gets or sets the style of check mark that is used if this WidgetAnnotation is linked with a CheckBoxField or a RadioButtonField.
Note that this property works over the 'buttonAppearance.Caption' property, for example if 'checkStyle' is "Cross", then 'buttonAppearance.Caption' will be "8".
If the value of this property is null, it indicates that ButtonAppearance.Caption contains an unknown value.
Returns
Set Signature
set checkStyle(value): void;
Gets or sets the style of check mark that is used if this WidgetAnnotation is linked with a CheckBoxField or a RadioButtonField.
Note that this property works over the 'buttonAppearance.Caption' property, for example if 'checkStyle' is "Cross", then 'buttonAppearance.Caption' will be "8".
If the value of this property is null, it indicates that ButtonAppearance.Caption contains an unknown value.
Parameters
value
Returns
void
contents
Get Signature
get contents(): string;
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.
Returns
string
Set Signature
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.
Parameters
value
string
Returns
void
Inherited from
defaultAppearance
Get Signature
get defaultAppearance(): DefaultAppearance;
Gets the DefaultAppearance object that specifies the visual properties (font, font size etc.) used to format the content of this annotation.
Returns
doc
Get Signature
get doc(): PdfDocument;
Gets the PdfDocument owning this annotation.
Returns
Inherited from
enter
Get Signature
get enter(): ActionBase;
Gets or sets an action to be performed when the annotation receives the input focus.
Returns
Set Signature
set enter(value): void;
Gets or sets an action to be performed when the annotation receives the input focus.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
flags
Get Signature
get flags(): AnnotationFlags;
Gets or sets the flags specifying various characteristics of the annotation.
Returns
Set Signature
set flags(value): void;
Gets or sets the flags specifying various characteristics of the annotation.
Parameters
value
Returns
void
Inherited from
highlighting
Get Signature
get highlighting(): HighlightingMode;
Gets or sets the annotation's highlighting mode.
Returns
Set Signature
set highlighting(value): void;
Gets or sets the annotation's highlighting mode.
Parameters
value
Returns
void
id
Get Signature
get id(): number;
Gets the reference to the object.
Returns
number
Inherited from
justification
Get Signature
get justification(): VariableTextJustification;
Gets or sets the justification to be used in displaying the annotation's text. Note that if this property is not specified (the value is null) then Field#justification is used. See PDF specification for details.
Returns
Set Signature
set justification(value): void;
Gets or sets the justification to be used in displaying the annotation's text. Note that if this property is not specified (the value is null) then Field#justification is used. See PDF specification for details.
Parameters
value
Returns
void
leave
Get Signature
get leave(): ActionBase;
Gets or sets an action to be performed when the annotation loses the input focus.
Returns
Set Signature
set leave(value): void;
Gets or sets an action to be performed when the annotation loses the input focus.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
locked
Get Signature
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.
Returns
boolean
Set Signature
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.
Parameters
value
boolean
Returns
void
Inherited from
lockedContents
Get Signature
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.
Returns
boolean
Set Signature
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.
Parameters
value
boolean
Returns
void
Inherited from
modifiedDate
Get Signature
get modifiedDate(): PdfDateTime;
Gets or sets the date and time when the annotation was modified.
Returns
Set Signature
set modifiedDate(value): void;
Gets or sets the date and time when the annotation was modified.
Parameters
value
Returns
void
Inherited from
mouseDown
Get Signature
get mouseDown(): ActionBase;
Gets or sets an action to be performed when the mouse button is pressed inside the field's active area.
Returns
Set Signature
set mouseDown(value): void;
Gets or sets an action to be performed when the mouse button is pressed inside the field's active area.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
mouseEnter
Get Signature
get mouseEnter(): ActionBase;
Gets or sets an action to be performed when the mouse enters the field's active area.
Returns
Set Signature
set mouseEnter(value): void;
Gets or sets an action to be performed when the mouse enters the field's active area.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
mouseLeave
Get Signature
get mouseLeave(): ActionBase;
Gets or sets an action to be performed when the cursor exits the field's active area.
Returns
Set Signature
set mouseLeave(value): void;
Gets or sets an action to be performed when the cursor exits the field's active area.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
mouseUp
Get Signature
get mouseUp(): ActionBase;
Gets or sets an action to be performed when the mouse button is released inside the field's active area.
Returns
Set Signature
set mouseUp(value): void;
Gets or sets an action to be performed when the mouse button is released inside the field's active area.
Parameters
value
| ActionProperties
| ActionBase
Returns
void
name
Get Signature
get name(): string;
Gets or sets the name of the annotation. If WidgetAnnotation is used with RadioButtonField then name is used as a value.
Returns
string
Set Signature
set name(value): void;
Gets or sets the name of the annotation. If WidgetAnnotation is used with RadioButtonField then name is used as a value.
Parameters
value
string
Returns
void
Overrides
om
Get Signature
get om(): ObjectManager;
Gets the owner ObjectManager instance.
Returns
Inherited from
page
Get Signature
get page(): PdfPage;
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.
Returns
Set Signature
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.
Parameters
value
Returns
void
Inherited from
pages
Get Signature
get pages(): AnnotationPagesCollection;
Gets the list of pages that reference this annotation.
Returns
Inherited from
pdfRect
Get Signature
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.
See
Returns
Set Signature
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.
See
Parameters
value
Returns
void
Inherited from
rect
Get Signature
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.
Returns
Set Signature
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.
Parameters
value
Returns
void
Inherited from
rotationAngle
Get Signature
get rotationAngle(): number;
Gets or sets the angle, in degrees, by which the widget annotation is rotated counterclockwise relative to the page. The value must be a multiple of 90.
Returns
number
Set Signature
set rotationAngle(value): void;
Gets or sets the angle, in degrees, by which the widget annotation is rotated counterclockwise relative to the page. The value must be a multiple of 90.
Parameters
value
number
Returns
void
Methods
createAppearanceContentStream()
createAppearanceContentStream(): FormXObject;
Creates an instance of FormXObject that can be used to define the annotation's appearance stream. Note that when this method is called, the annotation must already have been added to the document, otherwise an exception will be thrown.
Returns
The FormXObject object.
Inherited from
AnnotationBase.createAppearanceContentStream
free()
free(): void;
Detaches the object from the ObjectManager and deallocates its memory, if possible.
Returns
void
Inherited from
rebind()
rebind(omTo): void;
Rebinds the object from the current ObjectManager to the specified one.
Parameters
omTo
The new ObjectManager for the object.
Returns
void
Inherited from
removeAppearance()
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.
Returns
void
Inherited from
AnnotationBase.removeAppearance
resetAppearance()
resetAppearance(): void;
Forces regeneration of the annotation's appearance streams next time the document is saved.
Returns
void