[]
        
(Showing Draft Content)

CircleAnnotation

Class: CircleAnnotation

Represents a circle annotation, which displays a circle on a page. When opened, they display a pop-up window containing the text of the associated note.

Extends

Constructors

Constructor

new CircleAnnotation(om): CircleAnnotation;

Creates a new CircleAnnotation.

Parameters

om

ObjectManager

ObjectManager that controls the lifetime of the CircleAnnotation.

Returns

CircleAnnotation

Overrides

SquareAnnotation.constructor

Constructor

new CircleAnnotation(): CircleAnnotation;

Creates a new CircleAnnotation.

Returns

CircleAnnotation

Overrides

SquareAnnotation.constructor

Accessors

appearanceStreams

Get Signature

get appearanceStreams(): AppearanceStreams;

Gets the AppearanceStreams object providing access to the annotation's appearance streams.

Returns

AppearanceStreams

Inherited from

SquareAnnotation.appearanceStreams


associatedFiles

Get Signature

get associatedFiles(): AssociatedFiles;

Gets the list of embedded files associated with this annotation.

Returns

AssociatedFiles

Inherited from

SquareAnnotation.associatedFiles


borderEffect

Get Signature

get borderEffect(): BorderEffect;

Gets or sets the the border effect applied to the polygon.

Returns

BorderEffect

Set Signature

set borderEffect(value): void;

Gets or sets the the border effect applied to the polygon.

Parameters
value

| BorderEffectProperties | BorderEffect

Returns

void

Inherited from

SquareAnnotation.borderEffect


color

Get Signature

get color(): Color;

Gets or sets the annotation color, it used as color of popup window, lines color etc.

Returns

Color

Set Signature

set color(value): void;

Gets or sets the annotation color, it used as color of popup window, lines color etc.

Parameters
value

Color

Returns

void

Inherited from

SquareAnnotation.color


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

SquareAnnotation.contents


creationDate

Get Signature

get creationDate(): PdfDateTime;

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

Returns

PdfDateTime

Set Signature

set creationDate(value): void;

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

Parameters
value

PdfDateTime

Returns

void

Inherited from

SquareAnnotation.creationDate


doc

Get Signature

get doc(): PdfDocument;

Gets the PdfDocument owning this annotation.

Returns

PdfDocument

Inherited from

SquareAnnotation.doc


fillColor

Get Signature

get fillColor(): Color;

Gets or sets the fill color.

Returns

Color

Set Signature

set fillColor(value): void;

Gets or sets the fill color.

Parameters
value

Color

Returns

void

Inherited from

SquareAnnotation.fillColor


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

SquareAnnotation.flags


id

Get Signature

get id(): number;

Gets the reference to the object.

Returns

number

Inherited from

SquareAnnotation.id


lineDashPattern

Get Signature

get lineDashPattern(): number[];

Gets or sets the line dash pattern. Null means a solid line.

Returns

number[]

Set Signature

set lineDashPattern(value): void;

Gets or sets the line dash pattern. Null means a solid line.

Parameters
value

number[]

Returns

void

Inherited from

SquareAnnotation.lineDashPattern


lineWidth

Get Signature

get lineWidth(): number;

Gets or sets the line width in points.

Returns

number

Set Signature

set lineWidth(value): void;

Gets or sets the line width in points.

Parameters
value

number

Returns

void

Inherited from

SquareAnnotation.lineWidth


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

SquareAnnotation.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;

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

SquareAnnotation.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

SquareAnnotation.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

SquareAnnotation.name


om

Get Signature

get om(): ObjectManager;

Gets the owner ObjectManager instance.

Returns

ObjectManager

Inherited from

SquareAnnotation.om


opacity

Get Signature

get opacity(): number;

Gets or sets the opacity value to be used in painting the annotation. This value applies to all visible elements of the annotation in its closed state (including its background and border) but not to the pop-up window that appears when the annotation is opened.

Returns

number

Set Signature

set opacity(value): void;

Gets or sets the opacity value to be used in painting the annotation. This value applies to all visible elements of the annotation in its closed state (including its background and border) but not to the pop-up window that appears when the annotation is opened.

Parameters
value

number

Returns

void

Inherited from

SquareAnnotation.opacity


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;

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

PdfPage

Returns

void

Inherited from

SquareAnnotation.page


pages

Get Signature

get pages(): AnnotationPagesCollection;

Gets the list of pages that reference this annotation.

Returns

AnnotationPagesCollection

Inherited from

SquareAnnotation.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;

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

Parameters
value

Rect

Returns

void

Inherited from

SquareAnnotation.pdfRect


Get Signature

get popup(): PopupAnnotation;

Gets or sets the PopupAnnotation annotation for entering or editing text associated with this annotation. Setting this property changes the PopupAnnotation#parent property. A separate PopupAnnotation allows defining additional properties of the popup window: color, position etc.

Returns

PopupAnnotation

Set Signature

set popup(value): void;

Gets or sets the PopupAnnotation annotation for entering or editing text associated with this annotation. Setting this property changes the PopupAnnotation#parent property. A separate PopupAnnotation allows defining additional properties of the popup window: color, position etc.

Parameters
value

PopupAnnotation

Returns

void

Inherited from

SquareAnnotation.popup


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;

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

Rect

Returns

void

Inherited from

SquareAnnotation.rect


referenceAnnotation

Get Signature

get referenceAnnotation(): MarkupAnnotation;

Gets or sets the annotation referenced by this annotation.

Returns

MarkupAnnotation

Set Signature

set referenceAnnotation(value): void;

Gets or sets the annotation referenced by this annotation.

Parameters
value

MarkupAnnotation

Returns

void

Inherited from

SquareAnnotation.referenceAnnotation


referenceType

Get Signature

get referenceType(): string;

Gets or sets the relationship (reference type) between this annotation and the annotation specified by the 'referenceAnnotation' property. The referenced annotation should be on the same page with the current annotation. The valid values: "R" (reply), "Group"

Returns

string

Set Signature

set referenceType(value): void;

Gets or sets the relationship (reference type) between this annotation and the annotation specified by the 'referenceAnnotation' property. The referenced annotation should be on the same page with the current annotation. The valid values: "R" (reply), "Group"

Parameters
value

AnnotationReferenceType

Returns

void

Inherited from

SquareAnnotation.referenceType


richText

Get Signature

get richText(): string;

Gets or sets the text to be displayed in the pop-up window when the annotation is opened. This text can be formatted using HTML tags, see PDF specification for details.

Returns

string

Set Signature

set richText(value): void;

Gets or sets the text to be displayed in the pop-up window when the annotation is opened. This text can be formatted using HTML tags, see PDF specification for details.

Parameters
value

string

Returns

void

Inherited from

SquareAnnotation.richText


subject

Get Signature

get subject(): string;

Gets or sets the text representing a short description of the subject being addressed by the annotation.

Returns

string

Set Signature

set subject(value): void;

Gets or sets the text representing a short description of the subject being addressed by the annotation.

Parameters
value

string

Returns

void

Inherited from

SquareAnnotation.subject


userName

Get Signature

get userName(): string;

Gets or sets the text label to be displayed in the title bar of the annotation's pop-up window when open and active. By convention, this entry identifies the user who added the annotation.

Returns

string

Set Signature

set userName(value): void;

Gets or sets the text label to be displayed in the title bar of the annotation's pop-up window when open and active. By convention, this entry identifies the user who added the annotation.

Parameters
value

string

Returns

void

Inherited from

SquareAnnotation.userName

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

SquareAnnotation.createAppearanceContentStream


free()

free(): void;

Detaches the object from the ObjectManager and deallocates its memory, if possible.

Returns

void

Inherited from

SquareAnnotation.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

SquareAnnotation.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

SquareAnnotation.removeAppearance


resetAppearance()

resetAppearance(): void;

Forces regeneration of the annotation's appearance streams next time the document is saved.

Returns

void

Inherited from

SquareAnnotation.resetAppearance