MergeCells

合并单元格数组。如果合并成功，将返回合并后的单元格，否则返回 "null"。 -警告：任何行中的单元格数量和当前表格中的行数可能会更改。

语法

expression.MergeCells(aCells);

expression - 表示 ApiTable 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
aCells	必需	ApiTableCell[]		单元格数组。

返回值

ApiTableCell

示例

此示例合并单元格数组。

// 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);