LinkAnnotation

Class: LinkAnnotation

Represents a hypertext link.

Extends

AnnotationBase

Constructors

Constructor

new LinkAnnotation(om): LinkAnnotation;

Creates a new LinkAnnotation.

Parameters

om

ObjectManager

ObjectManager that controls the lifetime of the LinkAnnotation.

Returns

LinkAnnotation

Overrides

AnnotationBase.constructor

Constructor

new LinkAnnotation(): LinkAnnotation;

Creates a new LinkAnnotation.

Returns

LinkAnnotation

Overrides

AnnotationBase.constructor

Accessors

action

Get Signature

get action(): ActionBase;

Gets or sets the ActionBase to be performed when this LinkAnnotation is activated. If both 'dest' and 'action' are specified, the viewer application will determine the behavior, which may be unpredictable. For consistent results, specify only one.

Returns

ActionBase

Set Signature

set action(value): void;

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

AppearanceStreams

Inherited from

AnnotationBase.appearanceStreams

associatedFiles

Get Signature

get associatedFiles(): AssociatedFiles;

Gets the list of embedded files associated with this annotation.

Returns

AssociatedFiles

Inherited from

AnnotationBase.associatedFiles

border

Get Signature

get border(): Border;

Gets or sets the annotation border.

Returns

Border

Set Signature

set border(value): void;

Gets or sets the annotation border.

Parameters

value

| BorderProperties | Border

Returns

void

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;

Parameters

value

string

Returns

void

Inherited from

AnnotationBase.contents

dest

Get Signature

get dest(): DestinationBase;

Gets or sets the "destination" object to be displayed when this LinkAnnotation is activated. If both 'dest' and 'action' are specified, the viewer application will determine the behavior, which may be unpredictable. For consistent results, specify only one.

Returns

DestinationBase

Set Signature

set dest(value): void;

Parameters

value

| DestinationProperties | DestinationBase

Returns

void

doc

Get Signature

get doc(): PdfDocument;

Gets the PdfDocument owning this annotation.

Returns

PdfDocument

Inherited from

AnnotationBase.doc

flags

Get Signature

get flags(): AnnotationFlags;

Gets or sets the flags specifying various characteristics of the annotation.

Returns

AnnotationFlags

Set Signature

set flags(value): void;

Gets or sets the flags specifying various characteristics of the annotation.

Parameters

value

AnnotationFlags

Returns

void

Inherited from

AnnotationBase.flags

highlighting

Get Signature

get highlighting(): HighlightingMode;

Gets or sets the annotation's highlighting mode.

Returns

HighlightingMode

Set Signature

set highlighting(value): void;

Gets or sets the annotation's highlighting mode.

Parameters

value

HighlightingMode

Returns

void

id

Get Signature

get id(): number;

Gets the reference to the object.

Returns

number

Inherited from

AnnotationBase.id

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;

Parameters

value

boolean

Returns

void

Inherited from

AnnotationBase.locked

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;

Parameters

value

boolean

Returns

void

Inherited from

AnnotationBase.lockedContents

modifiedDate

Get Signature

get modifiedDate(): PdfDateTime;

Gets or sets the date and time when the annotation was modified.

Returns

PdfDateTime

Set Signature

set modifiedDate(value): void;

Gets or sets the date and time when the annotation was modified.

Parameters

value

PdfDateTime

Returns

void

Inherited from

AnnotationBase.modifiedDate

name

Get Signature

get name(): string;

Gets or sets the annotation name, a text string uniquely identifying it among all annotations on its page.

Returns

string

Set Signature

set name(value): void;

Gets or sets the annotation name, a text string uniquely identifying it among all annotations on its page.

Parameters

value

string

Returns

void

Inherited from

AnnotationBase.name

om

Get Signature

get om(): ObjectManager;

Gets the owner ObjectManager instance.

Returns

ObjectManager

Inherited from

AnnotationBase.om

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

PdfPage

Set Signature

set page(value): void;

Parameters

value

PdfPage

Returns

void

Inherited from

AnnotationBase.page

pages

Get Signature

get pages(): AnnotationPagesCollection;

Gets the list of pages that reference this annotation.

Returns

AnnotationPagesCollection

Inherited from

AnnotationBase.pages

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

rect

Returns

Rect

Set Signature

set pdfRect(value): void;

See

rect

Parameters

value

Rect

Returns

void

Inherited from

AnnotationBase.pdfRect

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

Rect

Set Signature

set rect(value): void;

Parameters

value

Rect

Returns

void

Inherited from

AnnotationBase.rect

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

FormXObject

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

AnnotationBase.free

rebind()

rebind(omTo): void;

Rebinds the object from the current ObjectManager to the specified one.

Parameters

omTo

ObjectManager

The new ObjectManager for the object.

Returns

void

Inherited from

AnnotationBase.rebind

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

Inherited from

AnnotationBase.resetAppearance