DS Server

Javascript: ImageCollection.addAtFixedPositionOnPage Method

Method|Introduced in 28.0

Description

Inserts a new image which has a fixed geometrical position in the document. This position is specified through a page number and a location on this page.

Syntax

<void> ImageCollection.addAtFixedPositionOnPage(<string> imageData, <number> pageNumber, <Point> location, <ImageInsertionMode> insertionMode, [<RequestImageCallback> callback], [<ErrorCallback> errorCallback])

Parameters

Parameter	Description
imageData	The base64 encoded image data.
pageNumber	Specifies the number of a page beginning with 1 where the image is located.
location	Specifies the location, in twips, at which the image is to be inserted. This is a location relative to the top left corner either of a page or of a paragraph.
insertionMode	Specifies how the text flow is handled.
callback	Optional. The newly created image object is returned via this callback function.
errorCallback	Optional. Is called when the operation failed with an error.

Examples

The following example demonstrates ImageCollection.addAtFixedPositionOnPage in a practical document-editing workflow. It inserts a new image which has a fixed geometrical position in the document. This position is specified through a page number and a location on this page.

function onTxError(error) {
    console.error("TX Text Control error:", error.msg);
    error.handled = true;
}

TXTextControl.images.addAtFixedPositionOnPage(
    "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAFgAH/qbPzWQAAAABJRU5ErkJggg==",
    1,
    { x: 1440, y: 720 },
    TXTextControl.ImageInsertionMode.AsCharacter,
    function(image) {
        if (!image) {
            console.warn("No image was returned.");
            return;
        }
        
        console.log("add at fixed position on page result:", image);
    },
    onTxError
);