TX Text Control .NET Server

HypertextLink Object

Object|Introduced in 28.0

Description

The HypertextLink object represents a hypertext link in a document that points to a target outside of the document.

Syntax

HypertextLink

Examples

The following example demonstrates HypertextLink in a practical document-editing workflow. The HypertextLink object represents a hypertext link in a document that points to a target outside of the document.

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

TXTextControl.textParts.getMainText(function(mainText) {
    const hypertextLinks = mainText.hypertextLinks;
    hypertextLinks.getItem(function(hypertextLink) {
        if (!hypertextLink) {
            console.warn("No hypertext link is available at the current input position.");
            return;
        }
    
        hypertextLink.getDescriptiveText(
            function(result) {
                console.log("get descriptive text result:", result);
            },
            onTxError
        );
    }, onTxError);
}, onTxError);

Members

Methods

MethodDescription
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 hyperlink's descriptive text. An empty string indicates that the link has no such text.
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.)
getTargetGets a string that specifies the target to where the hypertext link points.
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 hyperlink's descriptive text. An empty string or null can be used to delete a previously set text.
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.)
setTargetSets a string that specifies the target to where the hypertext link points.
setTextSets the text which is contained within a text field. (Inherited from TextField.)