DS Server

Javascript: InputPosition.getLocation Method

Method|Introduced in 28.0

Description

Gets the geometric location of the current text input position.

Syntax

<void> InputPosition.getLocation(<RequestPointCallback> callback, [<ErrorCallback> errorCallback])

Parameters

ParameterDescription
callback

Receives the geometric location of the current text input position.

errorCallback

Optional. Is called when the operation failed with an error.

Examples

The following example demonstrates InputPosition.getLocation in a practical document-editing workflow. It gets the geometric location of the current text input position.

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

TXTextControl.inputPosition.getLocation(
    function(position) {
        if (!position) {
            console.warn("No point was returned.");
            return;
        }
        
        console.log("get location result:", position);
    },
    onTxError
);