RemoveElement

Removes an element using the position specified.

note

If the element you remove is the last paragraph element (i.e. all the elements are removed from the paragraph), a new empty run is automatically created. If you want to add content to this run, use the ApiParagraph#GetElement method.

Syntax

expression.RemoveElement(nPos);

expression - A variable that represents an ApiParagraph class.

Parameters

Name	Required/Optional	Data type	Default	Description
nPos	Required	number		The element position which we want to remove from the paragraph.

Returns

boolean

Example

Delete a specific element from a paragraph object in a PDF.

// Useful for removing an element by its position in a paragraph in a PDF.

// Eliminate an element at a given index from a paragraph in a PDF.

const doc = Api.GetDocument();
const page = doc.GetPage(0);

const gs1 = Api.CreateGradientStop(Api.RGB(255, 213, 191), 0);
const gs2 = Api.CreateGradientStop(Api.RGB(255, 111, 61), 100000);
const fill = Api.CreateRadialGradientFill([gs1, gs2]);
const stroke = Api.CreateStroke(0, Api.CreateNoFill());
const shape = Api.CreateShape("flowChartMagneticTape", 150 * 36000, 65 * 36000, fill, stroke);
shape.SetPosition(608400, 1267200);

const docContent = shape.GetContent();
const paragraph = docContent.GetElement(0);
paragraph.RemoveAllElements();

let run = Api.CreateRun();
run.AddText("Run 1. ");
paragraph.AddElement(run);

run = Api.CreateRun();
run.AddText("Run 2. ");
paragraph.AddElement(run);

run = Api.CreateRun();
run.AddText("Run 3. ");
paragraph.AddElement(run);

run = Api.CreateRun();
run.AddText("Run 4. ");
paragraph.AddElement(run);

run = Api.CreateRun();
run.AddText("Run 5. ");
paragraph.AddElement(run);

paragraph.RemoveElement(3);

page.AddObject(shape);