SetCellHyperlink Function

Attaches a given hyperlink to the characters given as a continuous range in a given cell of a given table item from an Envision document currently opened in the Canvas Envision Creator app.

    SetCellHyperlink(
        tableObj: [[[EvItem|canvas-envision-document-items.html#object-items]]],
        cell: [[[EvTableCellIndex|evtablecellindex-type-alias.html]]],
        link: [[[EvHyperlink|evhyperlink-interface.html]]],
        span?: [[[EvCharSpan|evcharspan-interface.html]]]
    ): Promise<void>

Parameters

tableObj: EvItem

An Object item object, a table item from the Envision document currently opened in the Canvas Envision Creator app that includes the given cell with the given range of characters to which the given hyperlink should be attached.

If a given object item is not a table, the function throws an error.

cell: EvTableCellIndex

An EvTableCellIndex object, an array of the row and column indices of a given cell with the given range of characters to which the given hyperlink should be attached.

link: EvHyperlink

An EvHyperlink object, a given hyperlink that should be attached to the characters within the given range in the given cell of the given table item.

span?: EvCharSpan

An EvCharSpan object, a given continuous range of characters to which the given hyperlink should be attached.

The default value is the entire text in the given cell.

Return value

Promise<void>: A Promise that, if fulfilled, resolves to void if the given hyperlink has been successfully attached to the characters within the given range in the given cell of the given table item in the current document.

Discussion

If a hyperlink is already attached to the given range of characters, the given new hyperlink replaces that attached hyperlink.

17 April 2025