Skip to main content

ReplaceTextSmart

Replaces each paragraph (or text in cell) in the select with the corresponding text from an array of strings.

Syntax

expression.ReplaceTextSmart(textStrings, tab, newLine);

expression - A variable that represents a Api class.

Parameters

NameRequired/OptionalData typeDefaultDescription
textStringsRequiredstring[]An array of replacement strings.
tabOptionalstring"\t"A character which is used to specify the tab in the source text.
newLineOptionalstring"\r\n"A character which is used to specify the line break character in the source text.

Returns

boolean

Example

Replace selected text with new text while keeping the original bold and italic formatting in a document.

// How do I replace text without losing its bold or italic styling in a document?

// Swap out paragraph text for new content and retain the existing character formatting in a document.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
paragraph.AddText("This is the normal text. ");
paragraph.AddText("The is bold text. ").SetBold(true);
paragraph.AddText("This is italic text.").SetItalic(true);

paragraph.GetRange().Select();
Api.ReplaceTextSmart(["This is the normal text. This bold text was smart replaced. This is italic text."]);