ReplaceByElement

Replaces the current table with a new element.

Syntax

expression.ReplaceByElement(oElement);

expression - A variable that represents a ApiTable class.

Parameters

Name	Required/Optional	Data type	Default	Description
oElement	Required	DocumentElement		The element to replace the current table with.

Returns

boolean

Example

Swap out a table for a paragraph in a document.

// How do I replace a table with a paragraph in a document?

// Substitute a table with a block of text to simplify content in a document.

let doc = Api.GetDocument();
let table = Api.CreateTable(3, 3);
doc.AddElement(0, table);
let tableStyle = doc.CreateStyle("CustomTableStyle", "table");
tableStyle.SetBasedOn(doc.GetStyle("Bordered"));
table.SetStyle(tableStyle);
let paragraph = Api.CreateParagraph();
paragraph.AddText("The table was replaced with the current paragraph.");
table.ReplaceByElement(paragraph);