管理 JavaScript 中的演示文稿表格

本页内容简介

使用 JavaScript 及 Node.js 版 Aspose.Slides，在 PowerPoint 幻灯片中创建并编辑表格。发现简洁的代码示例，以简化您的表格工作流程。

简介

PowerPoint 中的表格将信息组织成行和列，使阅读和比较数值更加容易。

Aspose.Slides 提供了 Table 类、Cell 类以及其他类型，以便在演示文稿中创建、更新和管理表格。

从头创建表格

通过指定位置、列宽和行高来创建表格。将其添加到幻灯片后，您可以设置单元格边框、合并单元格并插入文本。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
定义一个以点为单位的列宽数组。
定义一个以点为单位的行高数组。
通过 addTable 方法向幻灯片添加一个 Table 对象。
遍历每个 Cell 并为上、下、左、右边框应用格式。
合并表格第一行的前两个单元格。
通过其 getTextFrame 方法访问合并后的单元格。
设置合并单元格中的文本。
保存修改后的演示文稿。

下面的示例在 (100, 50) 点处创建一个包含三列五行的表格。它为单元格设置宽度为 5 点的红色边框，合并首行的前两个单元格，并将结果保存为 table.pptx。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const red = java.getStaticFieldValue("java.awt.Color", "RED");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [50, 50, 50]);
    const rowHeights = java.newArray("double", [50, 30, 30, 30, 30]);
    const table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (let i = 0; i < table.getRows().size(); i++) {
        const row = table.getRows().get_Item(i);
        for (let j = 0; j < row.size(); j++) {
            const cell = row.get_Item(j);
            const cellFormat = cell.getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderRight().setWidth(5);
        }
    }

    table.mergeCells(table.get_Item(0, 0), table.get_Item(1, 0), false);
    table.get_Item(0, 0).getTextFrame().setText("Merged Cells");

    presentation.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

标准表格中的编号

在标准表格中，单元格索引从零开始，顺序为（列，行）。第一个单元格的索引为 (0, 0)。

例如，具有 4 列 4 行的表格中的单元格编号如下：

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

此示例创建上图所示的 4 × 4 表格，列宽和行高均为 70 点，单元格边框为宽度 5 点的红色。坐标用于说明单元格索引；示例保持单元格为空并将表格保存为 StandardTables_out.pptx。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const red = java.getStaticFieldValue("java.awt.Color", "RED");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [70, 70, 70, 70]);
    const rowHeights = java.newArray("double", [70, 70, 70, 70]);
    const table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (let i = 0; i < table.getRows().size(); i++) {
        const row = table.getRows().get_Item(i);
        for (let j = 0; j < row.size(); j++) {
            const cell = row.get_Item(j);
            const cellFormat = cell.getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(red);
            cellFormat.getBorderRight().setWidth(5);
        }
    }

    presentation.save("StandardTables_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

访问现有表格

表格存储在幻灯片的形状集合中。遍历形状以定位表格，然后使用 Table 类读取或更新其单元格。

使用 Presentation 类加载演示文稿。
通过索引获取包含表格的幻灯片的引用。
遍历 Shape 对象并在找到表格时停止。如果幻灯片包含多个表格，请使用 getAlternativeText 来识别所需的表格。
更新目标单元格中的文本。
保存修改后的演示文稿。

下面的示例打开 UpdateExistingTable.pptx 并在第一张幻灯片上找到第一个表格。它将列 0、行 1 的单元格设置为 New，并将结果保存为 table1_out.pptx。输入必须至少包含一张幻灯片，并且该幻灯片上的第一个表格必须至少有一列两行。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("UpdateExistingTable.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    let table = null;

    for (let i = 0; i < slide.getShapes().size(); i++) {
        const shape = slide.getShapes().get_Item(i);
        if (java.instanceOf(shape, "com.aspose.slides.ITable")) {
            table = shape;
            break;
        }
    }

    if (table != null) {
        table.get_Item(0, 1).getTextFrame().setText("New");
        presentation.save("table1_out.pptx", aspose.slides.SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

要调整现有表格中行的大小并了解其实际高度为何可能超过请求的最小值，请参阅控制行高。

查找拥有 TextFrame 的单元格

当通用文本处理代码从表格中收到一个 TextFrame 时，使用 TextFrame.getParentCell 方法检索拥有该文本框的 Cell。对于表格单元格的文本框，TextFrame.getParentCell 返回拥有者，而 TextFrame.getParentShape 返回 null，即使表格本身是一个形状。

可以通过只读的 Cell.getFirstColumnIndex 和 Cell.getFirstRowIndex 方法获取单元格坐标。TextFrame.getParentCell 还提供只读导航：它返回所有者但不更改所有权。使用前务必检查返回的单元格是否为 null。

有关完整示例（包括识别表格单元格和形状所有者以及与 SmartArt 节点关联的形状），请参阅搜索和替换文本。

对齐表格中的文本

您可以控制各个表格单元格的垂直锚点和文本方向。本节示例将第一单元格中的文本居中并旋转 270 度。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
向幻灯片添加一个 Table 对象。
从表格中获取一个 TextFrame 对象。
获取第一个 Paragraph 并设置其文本和颜色。
使用 setTextAnchorType 和 setTextVerticalType 设置单元格的垂直锚点和文本方向。
保存修改后的演示文稿。

此示例创建一个 4 × 4 表格，列宽为 120 点，行高为 100 点。它对单元格 (0, 0) 的文本进行格式化，向首行其余单元格添加值，并将结果保存为 Vertical_Align_Text_out.pptx。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const black = java.getStaticFieldValue("java.awt.Color", "BLACK");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [120, 120, 120, 120]);
    const rowHeights = java.newArray("double", [100, 100, 100, 100]);
    const table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(1, 0).getTextFrame().setText("10");
    table.get_Item(2, 0).getTextFrame().setText("20");
    table.get_Item(3, 0).getTextFrame().setText("30");

    const textFrame = table.get_Item(0, 0).getTextFrame();
    const paragraph = textFrame.getParagraphs().get_Item(0);

    const portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(black);

    const cell = table.get_Item(0, 0);
    cell.setTextAnchorType(java.newByte(aspose.slides.TextAnchorType.Center));
    cell.setTextVerticalType(java.newByte(aspose.slides.TextVerticalType.Vertical270));

    presentation.save("Vertical_Align_Text_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在表格级别设置文本格式

使用 setTextFormat 可对表格中所有单元格应用文本格式。其重载接受部分、段落和文本框格式，从而无需遍历单元格即可设置这些属性。

使用 Presentation 类加载演示文稿。
通过索引获取幻灯片的引用。
从幻灯片获取一个 Table 对象。
使用 setFontHeight 为文本设置字体大小。
使用 setAlignment 和 setMarginRight 设置段落对齐方式和右边距。
使用 setTextVerticalType 设置文本方向。
保存修改后的演示文稿。

下面的示例打开 table.pptx（该文件必须至少包含一张包含表格的幻灯片，表格为第一形状）。它将字体大小设为 25 点，段落右对齐并设置右边距为 20 点，使文本垂直显示。格式化后的演示文稿保存为 result.pptx。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("table.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const table = slide.getShapes().get_Item(0);

    const portionFormat = new aspose.slides.PortionFormat();
    portionFormat.setFontHeight(25);
    table.setTextFormat(portionFormat);

    const paragraphFormat = new aspose.slides.ParagraphFormat();
    paragraphFormat.setAlignment(aspose.slides.TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.setTextFormat(paragraphFormat);

    const textFrameFormat = new aspose.slides.TextFrameFormat();
    textFrameFormat.setTextVerticalType(java.newByte(aspose.slides.TextVerticalType.Vertical));
    table.setTextFormat(textFrameFormat);

    presentation.save("result.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

获取表格样式属性

使用 getStylePreset 可读取表格的预设样式，使用 setStylePreset 可为其分配样式。此示例对一个表格应用 TableStylePreset.DarkStyle1，打印预设值，并将相同的预设分配给第二个表格。两个表格均保存在 table-style.pptx 中。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [100, 150]);
    const rowHeights = java.newArray("double", [5, 5, 5]);
    const table = slide.getShapes().addTable(10, 10, columnWidths, rowHeights);
    table.setStylePreset(aspose.slides.TableStylePreset.DarkStyle1);

    const stylePreset = table.getStylePreset();
    console.log("Table style preset: " + stylePreset);

    const anotherTable = slide.getShapes().addTable(10, 100, columnWidths, rowHeights);
    anotherTable.setStylePreset(stylePreset);

    presentation.save("table-style.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

锁定表格的宽高比

表格的宽高比是其宽度与高度的比值。使用 setAspectRatioLocked 可以锁定该比例。

下面的示例打开 pres.pptx（该文件必须至少包含一张包含表格的幻灯片，表格为第一形状）。它打印当前的锁定状态，启用宽高比锁定，打印更新后的状态 (true)，并将结果保存为 pres-out.pptx。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("pres.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    const table = slide.getShapes().get_Item(0);
    console.log("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(true);
    console.log("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    presentation.save("pres-out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

常见问题

我可以为整个表格及其单元格中的文本启用从右到左 (RTL) 阅读方向吗？

可以。表格提供了 setRightToLeft 方法，段落则有 ParagraphFormat.setRightToLeft。同时使用两者可确保单元格内部的 RTL 顺序和渲染正确。

如何阻止用户在最终文件中移动或调整表格大小？

使用 shape locks 可禁用移动、调整大小、选择等。这些锁同样适用于表格。

是否支持在单元格内插入图像作为背景？

支持。您可以为单元格设置 picture fill，图像将根据所选模式（拉伸或平铺）覆盖单元格区域。

演示文稿查看器