在 .NET 中管理演示文稿表格

PowerPoint 中的表格是展示和表达信息的高效方式。网格单元格（按行列排列）中的信息直观易懂。

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

从头创建表格

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

下面的 C# 代码演示了如何在演示文稿中创建表格：

// 实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation();

// 访问第一张幻灯片
ISlide sld = pres.Slides[0];

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

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

// 为每个单元格设置边框格式
for (int row = 0; row < tbl.Rows.Count; row++)
{
	for (int cell = 0; cell < tbl.Rows[row].Count; cell++)
	{
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderTop.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.FillType = (FillType.Solid);
		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.SolidFillColor.Color= Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderBottom.Width =5;

		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.SolidFillColor.Color =Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderLeft.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderRight.Width = 5;
	}
}
// 合并第 1 行的第 1、2 个单元格
tbl.MergeCells(tbl.Rows[0][0], tbl.Rows[1][1], false);

// 为合并后的单元格添加文本
tbl.Rows[0][0].TextFrame.Text = "Merged Cells";

// 将演示文稿保存到磁盘
pres.Save("table.pptx", SaveFormat.Pptx);

标准表格中的编号

在标准表格中，单元格的编号是直观的零基索引。表格的第一个单元格索引为 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)

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

// 实例化表示 PPTX 文件的 Presentation 类
using (Presentation pres = new Presentation())
{

    // 访问第一张幻灯片
    ISlide sld = pres.Slides[0];

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

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

    // 为每个单元格设置边框格式
    foreach (IRow row in tbl.Rows)
    {
        foreach (ICell cell in row)
        {
			cell.CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderTop.Width = 5;

			cell.CellFormat.BorderBottom.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderBottom.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderBottom.Width = 5;

			cell.CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderLeft.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderLeft.Width = 5;

			cell.CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderRight.Width = 5;
        }
    }

    // 将演示文稿保存到磁盘
    pres.Save("StandardTables_out.pptx", SaveFormat.Pptx);
}

访问现有表格

  1. 创建 Presentation 类的实例。

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

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

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

    如果您确信当前幻灯片仅包含一个表格，可以直接检查其所有形状。当形状被识别为表格时，可将其强制转换为 Table 对象。但如果幻灯片包含多个表格，最好通过其 AlternativeText 来搜索所需的表格。

  5. 使用 ITable 对象对表格进行操作。下面的示例向表格添加了一行新行。

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

下面的 C# 代码演示了如何访问并操作现有表格：

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

    // 访问第一张幻灯片
    ISlide sld = pres.Slides[0];

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

    // 遍历形状并设置对找到的表格的引用
    foreach (IShape shp in sld.Shapes)
        if (shp is ITable)
            tbl = (ITable)shp;

    // 设置第二行第一列的文本
    tbl[0, 1].TextFrame.Text = "New";

    // 将修改后的演示文稿保存到磁盘
    pres.Save("table1_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

对表格中的文本进行对齐

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

下面的 C# 代码演示了如何对表格中的文本进行对齐：

// 创建 Presentation 类的实例
Presentation presentation = new Presentation();

// 获取第一张幻灯片
ISlide slide = presentation.Slides[0];

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

// 向幻灯片添加表格形状
ITable tbl = slide.Shapes.AddTable(100, 50, dblCols, dblRows);
tbl[1, 0].TextFrame.Text = "10";
tbl[2, 0].TextFrame.Text = "20";
tbl[3, 0].TextFrame.Text = "30";

// 访问文本框
ITextFrame txtFrame = tbl[0, 0].TextFrame;

// 为文本框创建 Paragraph 对象
IParagraph paragraph = txtFrame.Paragraphs[0];

// 为段落创建 Portion 对象
IPortion portion = paragraph.Portions[0];
portion.Text = "Text here";
portion.PortionFormat.FillFormat.FillType = FillType.Solid;
portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.Black;

// 垂直对齐文本
ICell cell = tbl[0, 0];
cell.TextAnchorType = TextAnchorType.Center;
cell.TextVerticalType = TextVerticalType.Vertical270;

// 将演示文稿保存到磁盘
presentation.Save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);

在表格级别设置文本格式

  1. 创建 Presentation 类的实例。
  2. 通过索引获取幻灯片的引用。
  3. 从幻灯片获取 ITable 对象。
  4. 设置文本的 FontHeight。
  5. 设置 Alignment 和 MarginRight。
  6. 设置 TextVerticalType。
  7. 保存修改后的演示文稿。

下面的 C# 代码演示了如何对表格中的文本应用首选的格式设置：

// 创建 Presentation 类的实例
Presentation presentation = new Presentation();
ISlide slide = presentation.Slides[0];

ITable someTable = presentation.Slides[0].Shapes[0] as ITable; // 假设第一张幻灯片上的第一个形状是表格

// Sets the table cells' font height
PortionFormat portionFormat = new PortionFormat();
portionFormat.FontHeight = 25;
someTable.SetTextFormat(portionFormat);

// Sets the table cells' text alignment and right margin in one call
ParagraphFormat paragraphFormat = new ParagraphFormat();
paragraphFormat.Alignment = TextAlignment.Right;
paragraphFormat.MarginRight = 20;
someTable.SetTextFormat(paragraphFormat);

// Sets the table cells' text vertical type
TextFrameFormat textFrameFormat = new TextFrameFormat();
textFrameFormat.TextVerticalType = TextVerticalType.Vertical;
someTable.SetTextFormat(textFrameFormat);


presentation.Save("result.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

获取表格样式属性

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

using (Presentation pres = new Presentation())
{
    ITable table = pres.Slides[0].Shapes.AddTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.StylePreset = TableStylePreset.DarkStyle1; // 更改默认样式预设主题
    pres.Save("table.pptx", SaveFormat.Pptx);
}

锁定表格的宽高比

几何形状的宽高比是其各维度尺寸的比例。Aspose.Slides 提供了 AspectRatioLocked 属性，帮助您锁定表格及其他形状的宽高比设置。

下面的 C# 代码演示了如何锁定表格的宽高比：

using (Presentation pres = new Presentation("pres.pptx"))
{
    ITable table = (ITable)pres.Slides[0].Shapes[0];
    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    table.ShapeLock.AspectRatioLocked = !table.ShapeLock.AspectRatioLocked; // 取反

    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

FAQ

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

可以。表格公开了 RightToLeft 属性，段落则具有 ParagraphFormat.RightToLeft。同时使用可确保单元格内部的 RTL 顺序和渲染正确。

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

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

是否支持在单元格内部将图片设为背景？

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

在 .NET 中管理 PowerPoint 表格的行和列