TX Text Control .NET Server

DocumentLink Object

Object|Introduced in 28.0

Description

The DocumentLink object represents a text position in a Text Control document that is a target of a document link.

Syntax

DocumentLink

Examples

The following example demonstrates DocumentLink in a practical document-editing workflow. The DocumentLink object represents a text position in a Text Control document that is a target of a document link.

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

TXTextControl.textParts.getMainText(function(mainText) {
    const documentLinks = mainText.documentLinks;
    documentLinks.getItem(function(documentLink) {
        if (!documentLink) {
            console.warn("No document link is available at the current input position.");
            return;
        }
    
        documentLink.getAutoGenerationType(
            function(result) {
                console.log("get auto generation type result:", result);
            },
            onTxError
        );
    }, onTxError);
}, onTxError);

Members

Methods

MethodDescription
getAutoGenerationTypeGets the type of auto-generation. A document link in a table of contents is automatically generated when the table of contents is inserted into the document.
getBoundsGets the bounding rectangle of a text field. (Inherited from TextField.)
getContainsInputPositionReturns true, if the Textfield contains the current text input position. (Inherited from TextField.)
getDeleteableGets whether a text field can be deleted by the end-user while a TX Text Control document is being edited. (Inherited from TextField.)
getDescriptiveTextGets the document link's descriptive text. An empty string indicates that the link has no such text.
getDocumentTargetGets an object of the type DocumentTarget specifying to where the link points.
getDoubledInputPositionSets whether a text field has a doubled input position in front of its first character and behind its last character. (Inherited from TextField.)
getEditableGets whether the text of a text field can be changed by the end-user while a TX Text Control document is being edited. (Inherited from TextField.)
getFormattingBoundsGets the formatting rectangle of a text field. (Inherited from TextField.)
getHighlightColorGets the highlight color for the text field. (Inherited from TextField.)
getHighlightModeGets a value indicating when the text field is highlighted. (Inherited from TextField.)
getIDGets an identifier for a text field. (Inherited from TextField.)
getIsSpellCheckingEnabledGets whether a text field's text is checked on misspelled words. (Inherited from TextField.)
getLengthGets the number of characters in a text field. (Inherited from TextField.)
getNameRelates a user-defined name to a text field. (Inherited from TextField.)
getStartGets the first character position (one-based) of a text field. (Inherited from TextField.)
getTextGets the text which is contained within a text field. (Inherited from TextField.)
scrollToSets the current input position to the beginning of a text field and scrolls it into the visible part of the document. (Inherited from TextField.)
setDeleteableSets whether a text field can be deleted by the end-user while a TX Text Control document is being edited. (Inherited from TextField.)
setDescriptiveTextSets the document link's descriptive text. An empty string or null can be used to delete a previously set text.
setDocumentTargetSets an object of the type DocumentTarget specifying to where the link points.
setDoubledInputPositionGets whether a text field has a doubled input position in front of its first character and behind its last character. (Inherited from TextField.)
setEditableSets whether the text of a text field can be changed by the end-user while a TX Text Control document is being edited. (Inherited from TextField.)
setHighlightColorSets the highlight color for the text field. (Inherited from TextField.)
setHighlightModeSets a value indicating when the text field is highlighted. (Inherited from TextField.)
setIDSets an identifier for the text field. (Inherited from TextField.)
setIsSpellCheckingEnabledGets whether a text field's text is checked on misspelled words. (Inherited from TextField.)
setNameSets the name of a text field. (Inherited from TextField.)
setTextSets the text which is contained within a text field. (Inherited from TextField.)