在 Android 上管理演示文稿表格

本页内容简介

使用适用于 Android 的 Aspose.Slides 在 PowerPoint 幻灯片中创建和编辑表格。发现简洁的 Java 代码示例，以简化您的表格工作流程。

介绍

PowerPoint 中的表格是显示和呈现信息的高效方式。以行列排列的单元格网格中的信息直观且易于理解。

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

从头创建表格

1. 创建 Presentation 类的实例。
2. 通过索引获取幻灯片的引用。
3. 定义 columnWidth 数组。
4. 定义 rowHeight 数组。
5. 通过 addTable 方法向幻灯片添加一个 ITable 对象。
6. 遍历每个 ICell ，对其上下左右边框应用格式。
7. 合并表格第一行的前两个单元格。
8. 访问 ICell’s TextFrame。
9. 向 TextFrame 添加文本。
10. 保存修改后的演示文稿。

以下 Java 代码演示了如何在演示文稿中创建表格：

import com.aspose.slides.*;
import java.awt.Color;

// 实例化一个表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation();
try {
    // 访问第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);

    // 定义列宽和行高
    double[] dblCols = {50, 50, 50};
    double[] dblRows = {50, 30, 30, 30, 30};

    // 向幻灯片添加表格形状
    ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // 为每个单元格设置边框格式
    for (int row = 0; row < tbl.getRows().size(); row++)
    {
        for (int cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++)
        {
            ICellFormat cellFormat = tbl.getRows().get_Item(row).get_Item(cell).getCellFormat();
            
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }
    // 合并第 1 行的第 1 和第 2 个单元格
    tbl.mergeCells(tbl.getRows().get_Item(0).get_Item(0), tbl.getRows().get_Item(0).get_Item(1), false);

    // 向合并后的单元格添加一些文本
    tbl.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells");

    // 将演示文稿保存到磁盘
    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

标准表格中的编号

在标准表格中，单元格的编号方式简单且从零开始。表格的第一个单元格索引为 0,0（第 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)

以下 Java 代码演示了如何为表格中的单元格指定编号：

import com.aspose.slides.*;
import java.awt.Color;

// 实例化一个表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation();
try {
    // 访问第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);

    // 定义列宽和行高
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // 向幻灯片添加表格形状
    ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // 为每个单元格设置边框格式
    for (IRow row : tbl.getRows())
    {
        for (ICell cell : row)
        {
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderTop().setWidth(5);

            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderBottom().setWidth(5);

            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderLeft().setWidth(5);

            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderRight().setWidth(5);
        }
    }

    // 将演示文稿保存到磁盘
    pres.save("StandardTables_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

访问现有表格

1. 创建 Presentation 类的实例。

2. 通过索引获取包含该表格的幻灯片的引用。

3. 创建一个 ITable 对象并将其设为 null。

4. 遍历所有 IShape 对象直至找到表格。

   如果您怀疑当前幻灯片只包含一个表格，您可以直接检查它包含的所有形状。当形状被识别为表格时，您可以将其强制转换为 Table 对象。但如果幻灯片包含多个表格，最好通过其 setAlternativeText(String value) 查找所需的表格。

5. 使用 ITable 对象操作表格。在下面的示例中，我们设置表格中某个单元格的文本。

6. 保存修改后的演示文稿。

以下 Java 代码演示了如何访问并操作现有表格：

import com.aspose.slides.*;

// 实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation("UpdateExistingTable.pptx");
try {

    // 访问第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);

    // 将 TableEx 初始化为 null
    ITable tbl = null;

    // 遍历形状并将找到的表格设为引用
    for (IShape shp : sld.getShapes()) 
    {
        if (shp instanceof ITable) 
        {
            tbl = (ITable) shp;
            // 为第二行的第一列设置文本
            tbl.get_Item(0, 1).getTextFrame().setText("New");
        }
    }
    
    // 将修改后的演示文稿保存到磁盘
    pres.save("table1_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

查找拥有文本框的单元格

当通用文本处理代码从表格中获取到 ITextFrame 时，使用 ITextFrame.getParentCell 方法来检索其所属的 ICell。对于表格单元格的文本框，ITextFrame.getParentCell 返回其所有者，而 ITextFrame.getParentShape 返回 null，尽管表格本身是一个形状。

单元格坐标可通过只读的 ICell.getFirstColumnIndex 和 ICell.getFirstRowIndex 方法获取。ITextFrame.getParentCell 还提供只读的导航：它返回所有者但不改变所有权。在使用返回的单元格前，请始终检查其是否为 null。

有关完整示例，演示如何识别表格单元格和形状的所有者（包括与 SmartArt 节点关联的形状），请参阅 Search and Replace Text。

对齐表格中的文本

1. 创建 Presentation 类的实例。
2. 通过索引获取幻灯片的引用。
3. 向幻灯片添加一个 ITable 对象。
4. 从表格中获取一个 ITextFrame 对象。
5. 访问 ITextFrame 的 IParagraph。
6. 垂直对齐文本。
7. 保存修改后的演示文稿。

以下 Java 代码演示了如何对齐表格中的文本：

import com.aspose.slides.*;
import java.awt.Color;

// 创建 Presentation 类的实例
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片 
    ISlide slide = pres.getSlides().get_Item(0);
    
    // 定义列宽和行高
    double[] dblCols = { 120, 120, 120, 120 };
    double[] dblRows = { 100, 100, 100, 100 };
    
    // 向幻灯片添加表格形状
    ITable tbl = slide.getShapes().addTable(100, 50, dblCols, dblRows);
    tbl.get_Item(1, 0).getTextFrame().setText("10");
    tbl.get_Item(2, 0).getTextFrame().setText("20");
    tbl.get_Item(3, 0).getTextFrame().setText("30");
    
    // 访问文本框
    ITextFrame txtFrame = tbl.get_Item(0, 0).getTextFrame();
    
    // 为文本框创建 Paragraph 对象
    IParagraph paragraph = txtFrame.getParagraphs().get_Item(0);
    
    // 为段落创建 Portion 对象
    IPortion portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    
    // 垂直对齐文本
    ICell cell = tbl.get_Item(0, 0);
    cell.setTextAnchorType(TextAnchorType.Center);
    cell.setTextVerticalType(TextVerticalType.Vertical270);
    
    // 将演示文稿保存到磁盘
    pres.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

在表格级别设置文本格式

1. 创建 the Presentation 类的实例。
2. 通过索引获取幻灯片的引用。
3. 从幻灯片获取一个 ITable 对象。
4. 为文本设置 setFontHeight(float value)。
5. 设置 setAlignment(int value) 和 setMarginRight(float value)。
6. 设置 setTextVerticalType(byte value)。
7. 保存修改后的演示文稿。

以下 Java 代码演示了如何将首选格式应用于表格中的文本：

import com.aspose.slides.*;

// 创建 Presentation 类的实例
Presentation pres = new Presentation("simpletable.pptx");
try {
    // 假设第一张幻灯片上的第一个形状是一个表格
    ITable someTable = (ITable) pres.getSlides().get_Item(0).getShapes().get_Item(0);
    
    // 设置表格单元格的字体高度
    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    someTable.setTextFormat(portionFormat);
    
    // 一次性设置表格单元格的文本对齐方式和右侧边距
    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    someTable.setTextFormat(paragraphFormat);
    
    // 设置表格单元格的文本垂直类型
    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    someTable.setTextFormat(textFrameFormat);
    
    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

获取表格样式属性

Aspose.Slides 允许您检索表格的样式属性，以便在其他表格或其他位置使用这些细节。以下 Java 代码演示了如何从表格预设样式获取样式属性：

import com.aspose.slides.*;

Presentation pres = new Presentation();
try {
    ITable table = pres.getSlides().get_Item(0).getShapes().addTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.setStylePreset(TableStylePreset.DarkStyle1); // 更改默认样式预设主题

    // 获取表格的样式预设
    int stylePreset = table.getStylePreset();
    System.out.println("Table style preset: " + stylePreset);

    // 将检索到的样式预设应用于另一张表格
    ITable anotherTable = pres.getSlides().get_Item(0).getShapes().addTable(10, 100, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    anotherTable.setStylePreset(stylePreset);

    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

锁定表格的宽高比

几何形状的宽高比是其在不同维度上的尺寸比例。Aspose.Slides 提供了 setAspectRatioLocked 属性，允许您锁定表格及其他形状的宽高比设置。

以下 Java 代码演示了如何锁定表格的宽高比：

import com.aspose.slides.*;

Presentation pres = new Presentation("pres.pptx");
try {
    ITable table = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(!table.getGraphicalObjectLock().getAspectRatioLocked()); // 取反

    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

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

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

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

使用形状锁来禁用移动、缩放、选择等。这些锁同样适用于表格。

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

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