@syncfusion/ej2-pdf-export 30.1.42 → 31.1.17

package/dist/ej2-pdf-export.min.js

@@ -1,6 +1,6 @@
 /*!
 *  filename: ej2-pdf-export.min.js
-*  version : 30.1.42
+*  version : 31.1.17
 *  Copyright Syncfusion Inc. 2001 - 2024. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/dist/ej2-pdf-export.umd.min.js

@@ -1,6 +1,6 @@
 /*!
 *  filename: ej2-pdf-export.umd.min.js
-*  version : 30.1.42
+*  version : 31.1.17
 *  Copyright Syncfusion Inc. 2001 - 2024. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/dist/global/ej2-pdf-export.min.js

@@ -1,6 +1,6 @@
 /*!
 *  filename: ej2-pdf-export.min.js
-*  version : 30.1.42
+*  version : 31.1.17
 *  Copyright Syncfusion Inc. 2001 - 2024. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/dist/global/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 *  filename: index.d.ts
-*  version : 30.1.42
+*  version : 31.1.17
 *  Copyright Syncfusion Inc. 2001 - 2024. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/dist/ts/implementation/actions/action.d.ts

@@ -0,0 +1,50 @@
+import { IPdfWrapper } from './../../interfaces/i-pdf-wrapper';
+import { IPdfPrimitive } from './../../interfaces/i-pdf-primitives';
+import { PdfDictionary } from './../primitives/pdf-dictionary';
+import { DictionaryProperties } from './../input-output/pdf-dictionary-properties';
+/**
+ * `PdfAction` class represents base class for all action types.
+ * @private
+ */
+export declare abstract class PdfAction implements IPdfWrapper {
+    /**
+     * Specifies the Next `action` to perform.
+     * @private
+     */
+    private action;
+    /**
+     * Specifies the Internal variable to store `dictionary`.
+     * @private
+     */
+    private pdfDictionary;
+    /**
+     * Specifies the Internal variable to store `dictionary properties`.
+     * @private
+     */
+    protected dictionaryProperties: DictionaryProperties;
+    /**
+     * Initialize instance for `Action` class.
+     * @private
+     */
+    protected constructor();
+    /**
+     * Gets and Sets the `Next` action to perform.
+     * @private
+     */
+    next: PdfAction;
+    /**
+     * Gets and Sets the instance of PdfDictionary class for `Dictionary`.
+     * @private
+     */
+    readonly dictionary: PdfDictionary;
+    /**
+     * `Initialize` the action type.
+     * @private
+     */
+    protected initialize(): void;
+    /**
+     * Gets the `Element` as IPdfPrimitive class.
+     * @private
+     */
+    readonly element: IPdfPrimitive;
+}

package/dist/ts/implementation/actions/action.ts

@@ -0,0 +1,76 @@
+import { IPdfWrapper } from './../../interfaces/i-pdf-wrapper';
+import { IPdfPrimitive } from './../../interfaces/i-pdf-primitives';
+import { PdfDictionary } from './../primitives/pdf-dictionary';
+import { PdfReferenceHolder } from './../primitives/pdf-reference';
+import { PdfName } from './../primitives/pdf-name';
+import { DictionaryProperties } from './../input-output/pdf-dictionary-properties';
+/**
+ * `PdfAction` class represents base class for all action types.
+ * @private
+ */
+export abstract class PdfAction implements IPdfWrapper {
+    /**
+     * Specifies the Next `action` to perform.
+     * @private
+     */
+    private action : PdfAction = null;
+    /**
+     * Specifies the Internal variable to store `dictionary`.
+     * @private
+     */
+    private pdfDictionary : PdfDictionary;
+    /**
+     * Specifies the Internal variable to store `dictionary properties`.
+     * @private
+     */
+    protected dictionaryProperties : DictionaryProperties = new DictionaryProperties();
+    // Constructors
+    /**
+     * Initialize instance for `Action` class.
+     * @private
+     */
+    protected constructor() {
+        // super(); -> Object()
+        this.initialize();
+    }
+    // Properties
+    /**
+     * Gets and Sets the `Next` action to perform.
+     * @private
+     */
+    public get next() : PdfAction {
+        return this.action;
+    }
+    public set next(value : PdfAction) {
+        // if (this.action !== value) {
+        this.action = value;
+        this.dictionary.items.setValue(this.dictionaryProperties.next, new PdfReferenceHolder(this.action));
+        // }
+    }
+    /**
+     * Gets and Sets the instance of PdfDictionary class for `Dictionary`.
+     * @private
+     */
+    public get dictionary() : PdfDictionary {
+        if (typeof this.pdfDictionary === 'undefined') {
+            this.pdfDictionary = new PdfDictionary();
+        }
+        return this.pdfDictionary;
+    }
+    // Implementation
+    /**
+     * `Initialize` the action type.
+     * @private
+     */
+    protected initialize() : void {
+        this.dictionary.items.setValue(this.dictionaryProperties.type, new PdfName(this.dictionaryProperties.action));
+    }
+    // IPdfWrapper Members
+    /**
+     * Gets the `Element` as IPdfPrimitive class.
+     * @private
+     */
+    public get element() : IPdfPrimitive {
+        return this.dictionary;
+    }
+}

package/dist/ts/implementation/actions/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Actions classes
+ * @hidden
+ */
+export * from './action';
+export * from './uri-action';

package/dist/ts/implementation/actions/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Actions classes
+ * @hidden
+ */
+export * from './action';
+export * from './uri-action';

package/dist/ts/implementation/actions/uri-action.d.ts

@@ -0,0 +1,33 @@
+import { PdfAction } from './action';
+/**
+ * `PdfUriAction` class for initialize the uri related internals.
+ * @private
+ */
+export declare class PdfUriAction extends PdfAction {
+    /**
+     * Specifies the `uri` string.
+     * @default ''.
+     * @private
+     */
+    private uniformResourceIdentifier;
+    /**
+     * Initialize instance of `PdfUriAction` class.
+     * @private
+     */
+    constructor();
+    /**
+     * Initialize instance of `PdfUriAction` class.
+     * @private
+     */
+    constructor(uri: string);
+    /**
+     * Gets and Sets the value of `Uri`.
+     * @private
+     */
+    uri: string;
+    /**
+     * `Initialize` the internals.
+     * @private
+     */
+    protected initialize(): void;
+}

package/dist/ts/implementation/actions/uri-action.ts

@@ -0,0 +1,52 @@
+import { PdfAction } from './action';
+import { PdfString } from './../primitives/pdf-string';
+import { PdfName } from './../primitives/pdf-name';
+/**
+ * `PdfUriAction` class for initialize the uri related internals.
+ * @private
+ */
+export class PdfUriAction extends PdfAction {
+    // Fields
+    /**
+     * Specifies the `uri` string.
+     * @default ''.
+     * @private
+     */
+    private uniformResourceIdentifier : string = '';
+
+    // Constructors
+    /**
+     * Initialize instance of `PdfUriAction` class.
+     * @private
+     */
+    public constructor()
+    /**
+     * Initialize instance of `PdfUriAction` class.
+     * @private
+     */
+    public constructor(uri : string)
+    public constructor(uri ?: string) {
+        super();
+    }
+    // Properties
+    /**
+     * Gets and Sets the value of `Uri`.
+     * @private
+     */
+    public get uri() : string {
+        return this.uniformResourceIdentifier;
+    }
+    public set uri(value : string) {
+        this.uniformResourceIdentifier = value;
+        this.dictionary.items.setValue(this.dictionaryProperties.uri, new PdfString(this.uniformResourceIdentifier));
+    }
+    // Implementation
+    /**
+     * `Initialize` the internals.
+     * @private
+     */
+    protected initialize() : void {
+        super.initialize();
+        this.dictionary.items.setValue(this.dictionaryProperties.s, new PdfName(this.dictionaryProperties.uri));
+    }
+}

package/dist/ts/implementation/annotations/action-link-annotation.d.ts

@@ -0,0 +1,30 @@
+import { RectangleF } from './../drawing/pdf-drawing';
+import { PdfAction } from './../actions/action';
+import { PdfLinkAnnotation } from './link-annotation';
+/**
+ * Represents base class for `link annotations` with associated action.
+ * @private
+ */
+export declare abstract class PdfActionLinkAnnotation extends PdfLinkAnnotation {
+    /**
+     * Internal variable to store annotation's `action`.
+     * @default null
+     * @private
+     */
+    private pdfAction;
+    /**
+     * Internal variable to store annotation's `Action`.
+     * @private
+     */
+    abstract action: PdfAction;
+    /**
+     * Specifies the constructor for `ActionLinkAnnotation`.
+     * @private
+     */
+    constructor(rectangle: RectangleF);
+    /**
+     * get and set the `action`.
+     * @hidden
+     */
+    getSetAction(value?: PdfAction): PdfAction | void;
+}

package/dist/ts/implementation/annotations/action-link-annotation.ts

@@ -0,0 +1,43 @@
+import { RectangleF } from './../drawing/pdf-drawing';
+import { PdfAction } from './../actions/action';
+import { PdfLinkAnnotation } from './link-annotation';
+/**
+ * Represents base class for `link annotations` with associated action.
+ * @private
+ */
+export abstract class PdfActionLinkAnnotation extends PdfLinkAnnotation {
+    // Fields
+    /**
+     * Internal variable to store annotation's `action`.
+     * @default null
+     * @private
+     */
+    private pdfAction : PdfAction = null;
+    // Properties
+    /**
+     * Internal variable to store annotation's `Action`.
+     * @private
+     */
+    public abstract get action() : PdfAction;
+    public abstract set action(value : PdfAction);
+    // Constructors
+    /**
+     * Specifies the constructor for `ActionLinkAnnotation`.
+     * @private
+     */
+    public constructor(rectangle : RectangleF) {
+        super(rectangle);
+    }
+    //Public method
+    /**
+     * get and set the `action`.
+     * @hidden
+     */
+    public getSetAction(value ?: PdfAction) : PdfAction|void {
+        if (typeof value === 'undefined') {
+            return this.pdfAction;
+        } else {
+            this.pdfAction = value;
+        }
+    }
+}

package/dist/ts/implementation/annotations/annotation-collection.d.ts

@@ -0,0 +1,77 @@
+import { IPdfWrapper } from './../../interfaces/i-pdf-wrapper';
+import { PdfPage } from './../pages/pdf-page';
+import { PdfArray } from './../primitives/pdf-array';
+import { PdfAnnotation } from './../annotations/annotation';
+import { IPdfPrimitive } from './../../interfaces/i-pdf-primitives';
+import { DictionaryProperties } from './../input-output/pdf-dictionary-properties';
+/**
+ * `PdfAnnotationCollection` class represents the collection of 'PdfAnnotation' objects.
+ * @private
+ */
+export declare class PdfAnnotationCollection implements IPdfWrapper {
+    /**
+     * `Error` constant message.
+     * @private
+     */
+    private alreadyExistsAnnotationError;
+    /**
+     * `Error` constant message.
+     * @private
+     */
+    private missingAnnotationException;
+    /**
+     * Specifies the Internal variable to store fields of `PdfDictionaryProperties`.
+     * @private
+     */
+    protected dictionaryProperties: DictionaryProperties;
+    /**
+     * Parent `page` of the collection.
+     * @private
+     */
+    private page;
+    /**
+     * Array of the `annotations`.
+     * @private
+     */
+    private internalAnnotations;
+    /**
+     * privte `list` for the annotations.
+     * @private
+     */
+    lists: PdfAnnotation[];
+    /**
+     * Gets the `PdfAnnotation` object at the specified index. Read-Only.
+     * @private
+     */
+    annotations: PdfArray;
+    /**
+     * Initializes a new instance of the `PdfAnnotationCollection` class.
+     * @private
+     */
+    constructor();
+    /**
+     * Initializes a new instance of the `PdfAnnotationCollection` class with the specified page.
+     * @private
+     */
+    constructor(page: PdfPage);
+    /**
+     * `Adds` a new annotation to the collection.
+     * @private
+     */
+    add(annotation: PdfAnnotation): void | number;
+    /**
+     * `Adds` a Annotation to collection.
+     * @private
+     */
+    protected doAdd(annotation: PdfAnnotation): void | number;
+    /**
+     * `Set a color of an annotation`.
+     * @private
+     */
+    private setColor;
+    /**
+     * Gets the `Element` representing this object.
+     * @private
+     */
+    readonly element: IPdfPrimitive;
+}

package/dist/ts/implementation/annotations/annotation-collection.ts

@@ -0,0 +1,159 @@
+import { IPdfWrapper } from './../../interfaces/i-pdf-wrapper';
+import { PdfPage } from './../pages/pdf-page';
+import { PdfArray } from './../primitives/pdf-array';
+import { PdfReferenceHolder } from './../primitives/pdf-reference';
+import { PdfAnnotation } from './../annotations/annotation';
+import { IPdfPrimitive } from './../../interfaces/i-pdf-primitives';
+import { DictionaryProperties } from './../input-output/pdf-dictionary-properties';
+import { SizeF, RectangleF, PointF } from './../drawing/pdf-drawing';
+import { PdfStringLayouter, PdfStringLayoutResult } from './../graphics/fonts/string-layouter';
+import { PdfDocumentLinkAnnotation } from './document-link-annotation';
+import { PdfColorSpace } from './../graphics/enum';
+/**
+ * `PdfAnnotationCollection` class represents the collection of 'PdfAnnotation' objects.
+ * @private
+ */
+export class PdfAnnotationCollection implements IPdfWrapper {
+    // Constants
+    /**
+     * `Error` constant message.
+     * @private
+     */
+    private alreadyExistsAnnotationError : string = 'This annotatation had been already added to page';
+    /**
+     * `Error` constant message.
+     * @private
+     */
+    private missingAnnotationException : string = 'Annotation is not contained in collection.';
+    /**
+     * Specifies the Internal variable to store fields of `PdfDictionaryProperties`.
+     * @private
+     */
+    protected dictionaryProperties : DictionaryProperties = new DictionaryProperties();
+    /**
+     * Parent `page` of the collection.
+     * @private
+     */
+    private page : PdfPage;
+    /**
+     * Array of the `annotations`.
+     * @private
+     */
+    private internalAnnotations : PdfArray = new PdfArray();
+    /**
+     * privte `list` for the annotations.
+     * @private
+     */
+    public lists : PdfAnnotation[] = [];
+    /**
+     * Gets the `PdfAnnotation` object at the specified index. Read-Only.
+     * @private
+     */
+    public get annotations() : PdfArray {
+        return this.internalAnnotations;
+    }
+    public set annotations(value : PdfArray) {
+        this.internalAnnotations = value;
+    }
+    // Constructors
+    /**
+     * Initializes a new instance of the `PdfAnnotationCollection` class.
+     * @private
+     */
+    public constructor()
+    /**
+     * Initializes a new instance of the `PdfAnnotationCollection` class with the specified page.
+     * @private
+     */
+    public constructor(page : PdfPage)
+    public constructor(page ?: PdfPage) {
+        if (typeof page !== 'undefined') {
+            this.page = page;
+        }
+    }
+    // Public methods
+    /**
+     * `Adds` a new annotation to the collection. 
+     * @private
+     */
+    public add(annotation : PdfAnnotation) : void | number {
+        // this.SetPrint(annotation);
+        this.doAdd(annotation);
+    }
+    /**
+     * `Adds` a Annotation to collection.
+     * @private
+     */
+    /* tslint:disable */
+    protected doAdd(annotation : PdfAnnotation) : void | number {
+        if (typeof (annotation as PdfDocumentLinkAnnotation).destination !== 'undefined') {
+            let layout : PdfStringLayouter = new PdfStringLayouter();
+            let layoutResult : PdfStringLayoutResult = layout.layout(annotation.text, annotation.font, annotation.stringFormat, new SizeF((annotation.bounds.width), 0), false, new SizeF(0, 0));
+            let lastPosition : number = annotation.bounds.y;
+            if (layoutResult.lines.length === 1) {
+                let size : SizeF = annotation.font.measureString(layoutResult.lines[0].text);
+                annotation.bounds = new RectangleF(new PointF(annotation.bounds.x, lastPosition), size);
+                annotation.text = layoutResult.lines[0].text;
+                //Draw Annotation Text.
+                this.page.graphics.drawString(annotation.text, annotation.font, null, annotation.brush, annotation.bounds.x, annotation.bounds.y, annotation.bounds.width, annotation.bounds.height, null);
+                //Add annotation to dictionary.
+                annotation.setPage(this.page);
+                this.setColor(annotation);
+                this.internalAnnotations.add(new PdfReferenceHolder(annotation));
+                this.lists.push(annotation);
+            } else {
+                for (let i : number = 0; i < layoutResult.lines.length; i++) {
+                    let size : SizeF = annotation.font.measureString(layoutResult.lines[i].text);
+                    if (i === 0) {
+                        annotation.bounds = new RectangleF(annotation.bounds.x, lastPosition, size.width, size.height);
+                        annotation.text = layoutResult.lines[i].text;
+                        //Draw Annotation Text.
+                        this.page.graphics.drawString(annotation.text, annotation.font, null, annotation.brush, annotation.bounds.x, lastPosition, size.width, size.height, null);
+                        //Add annotation to dictionary.
+                        annotation.setPage(this.page);
+                        this.setColor(annotation);
+                        this.internalAnnotations.add(new PdfReferenceHolder(annotation));
+                        this.lists.push(annotation);
+                        //Update y for drawing next line of the text.
+                        lastPosition += annotation.bounds.height;
+                    } else {
+                        let annot : PdfDocumentLinkAnnotation = (annotation as PdfDocumentLinkAnnotation).clone();
+                        annot.bounds = new RectangleF(new PointF(annotation.bounds.x, lastPosition), size);
+                        annot.text = layoutResult.lines[i].text;
+                        //Draw Annotation Text.
+                        this.page.graphics.drawString(annot.text, annot.font, null, annot.brush, annot.bounds.x, annot.bounds.y, annot.bounds.width, annot.bounds.height, null);
+                        //Add annotation to dictionary.
+                        annot.setPage(this.page);
+                        this.setColor(annot);
+                        this.internalAnnotations.add(new PdfReferenceHolder(annot));
+                        this.lists.push(annot);
+                        //Update y for drawing next line of the text.
+                        lastPosition += annot.bounds.height;
+                    }
+                }
+            }
+        } else {
+            annotation.setPage(this.page);
+            this.internalAnnotations.add(new PdfReferenceHolder(annotation));
+            return this.lists.push(annotation);
+        }
+    }
+    /* tslint:enable */
+    /**
+     * `Set a color of an annotation`.
+     * @private
+     */
+    private setColor(annotation : PdfAnnotation) : void {
+        let cs : PdfColorSpace = PdfColorSpace.Rgb;
+        let colours : PdfArray = annotation.color.toArray(cs);
+        annotation.dictionary.items.setValue(this.dictionaryProperties.c, colours);
+    }
+    // IPdfWrapper Members
+    /**
+     * Gets the `Element` representing this object.
+     * @private
+     */
+    public get element() : IPdfPrimitive {
+        return this.internalAnnotations;
+    }
+}