MergeCells
Merges an array of cells. If merge is successful, it will return merged cell, otherwise "null". -Warning: The number of cells in any row and the number of rows in the current table may be changed.
Syntax
expression.MergeCells(aCells);
expression - A variable that represents a ApiTable class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| aCells | Required | ApiTableCell[] | The array of cells. |
Returns
Example
This example merges an array of cells.
- Code
- Result
// How to get two cells by their position index and merge them into one.
// Create a table, create cells and merge them into one.
const presentation = Api.GetPresentation();
const table = Api.CreateTable(2, 4);
const row = table.GetRow(0);
const cell1 = row.GetCell(0);
const cell2 = row.GetCell(1);
table.MergeCells([cell1, cell2]);
const cell = row.GetCell(0);
const content = cell.GetContent();
const paragraph = Api.CreateParagraph();
paragraph.AddText("This cell was formed by merging two cells.");
content.Push(paragraph);
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
slide.AddObject(table);