.NET 中的演示文稿文本框管理

幻灯片上的文本通常存在于文本框或形状中。因此，要向幻灯片添加文本，必须先添加文本框，然后在文本框中放入一些文本。

为了让您添加可以容纳文本的形状，Aspose.Slides for .NET 提供了 IAutoShape 接口。

Note

Aspose.Slides 还提供了 IShape 接口，以允许您向幻灯片添加形状。但是，并非所有通过 IShape 接口添加的形状都能容纳文本。通过 IAutoShape 接口添加的形状通常包含文本。

因此，在处理您想要添加文本的现有形状时，您可能需要检查并确认它是通过 IAutoShape 接口进行转型的。只有这样，您才能使用 IAutoShape 下的属性 TextFrame。请参阅本页的 Update Text 部分。

在幻灯片上创建文本框

创建 Presentation 类的实例。
通过索引获取第一张幻灯片的引用。
在幻灯片的指定位置添加一个 IAutoShape 对象，并将 ShapeType 设置为 Rectangle，然后获取新添加的 IAutoShape 对象的引用。
向 IAutoShape 对象添加一个 TextFrame 属性，以容纳文本。在下面的示例中，我们添加了以下文本：Aspose TextBox
最后，通过 Presentation 对象写入 PPTX 文件。

以下 C# 代码实现了上述步骤，演示了如何向幻灯片添加文本：

    // 实例化 PresentationEx
    using (Presentation pres = new Presentation())
    {
    
        // 获取演示文稿中的第一张幻灯片
        ISlide sld = pres.Slides[0];
    
        // 添加类型为 Rectangle 的 AutoShape
        IAutoShape ashp = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);
    
        // 向矩形添加 TextFrame
        ashp.AddTextFrame(" ");
    
        // 访问文本框架
        ITextFrame txtFrame = ashp.TextFrame;
    
        // 为文本框创建 Paragraph 对象
        IParagraph para = txtFrame.Paragraphs[0];
    
        // 为段落创建 Portion 对象
        IPortion portion = para.Portions[0];
    
        // 设置文本
        portion.Text = "Aspose TextBox";
    
        // 将演示文稿保存到磁盘
        pres.Save("TextBox_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
    }

检查文本框形状

Aspose.Slides 从 IAutoShape 接口提供了 IsTextBox 属性，允许您检查形状并识别文本框。

文本框和形状

以下 C# 代码展示了如何检查形状是否被创建为文本框：

using (Presentation presentation = new Presentation("sample.pptx"))
{
    Aspose.Slides.LowCode.ForEach.Shape(presentation, (shape, slide, index) =>
    {
        if (shape is IAutoShape autoShape)
        {
            Console.WriteLine(autoShape.IsTextBox ? "shape is a text box" : "shape is not a text box");
        }
    });
}

请注意，如果仅使用 IShapeCollection 接口的 AddAutoShape 方法添加自动形状，则该自动形状的 IsTextBox 属性将返回 false。但是，在使用 AddTextFrame 方法或 Text 属性向自动形状添加文本后，IsTextBox 属性将返回 true。

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
    // shape1.IsTextBox 为 false
    shape1.AddTextFrame("shape 1");
    // shape1.IsTextBox 为 true

    IAutoShape shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
    // shape2.IsTextBox 为 false
    shape2.TextFrame.Text = "shape 2";
    // shape2.IsTextBox 为 true

    IAutoShape shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
    // shape3.IsTextBox 为 false
    shape3.AddTextFrame("");
    // shape3.IsTextBox 为 false

    IAutoShape shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
    // shape4.IsTextBox 为 false
    shape4.TextFrame.Text = "";
    // shape4.IsTextBox 为 false
}

向文本框添加列

Aspose.Slides 提供了 ColumnCount 和 ColumnSpacing 属性（分别来自 ITextFrameFormat 接口和 TextFrameFormat 类），允许您向文本框添加列。您可以指定文本框中的列数，然后指定列之间的点间距。

以下 C# 代码演示了上述操作：

using (Presentation presentation = new Presentation())
{
	// 获取演示文稿中的第一张幻灯片
	ISlide slide = presentation.Slides[0];

	// 添加类型为 Rectangle 的 AutoShape
	IAutoShape aShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

	// 向矩形添加 TextFrame
	aShape.AddTextFrame("All these columns are limited to be within a single text container -- " +
	"you can add or delete text and the new or remaining text automatically adjusts " +
	"itself to flow within the container. You cannot have text flow from one container " +
	"to other though -- we told you PowerPoint's column options for text are limited!");

	// 获取 TextFrame 的文本格式
	ITextFrameFormat format = aShape.TextFrame.TextFrameFormat;

	// 指定 TextFrame 中的列数
	format.ColumnCount = 3;

	// 指定列之间的间距
	format.ColumnSpacing = 10;

	// 保存演示文稿
	presentation.Save("ColumnCount.pptx", SaveFormat.Pptx);
}

向文本框架添加列

Aspose.Slides for .NET 提供了 ColumnCount 属性（来自 ITextFrameFormat 接口），允许您在文本框架中添加列。通过此属性，您可以指定文本框架中所需的列数。

以下 C# 代码展示了如何在文本框架中添加列：

string outPptxFileName = "ColumnsTest.pptx";
using (Presentation pres = new Presentation())
{
    IAutoShape shape1 = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
    TextFrameFormat format = (TextFrameFormat)shape1.TextFrame.TextFrameFormat;

    format.ColumnCount = 2;
    shape1.TextFrame.Text = "All these columns are forced to stay within a single text container -- " +
                                "you can add or delete text - and the new or remaining text automatically adjusts " +
                                "itself to stay within the container. You cannot have text spill over from one container " +
                                "to other, though -- because PowerPoint's column options for text are limited!";
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(2 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(double.NaN == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }

    format.ColumnSpacing = 20;
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(2 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(20 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }

    format.ColumnCount = 3;
    format.ColumnSpacing = 15;
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(3 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(15 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }
}

更新文本

Aspose.Slides 允许您更改或更新文本框中的文本，或演示文稿中所有文本。

以下 C# 代码演示了在演示文稿中更新或更改所有文本的操作：

using(Presentation pres = new Presentation("text.pptx"))
{
   foreach (ISlide slide in pres.Slides)
   {
       foreach (IShape shape in slide.Shapes)
       {
           if (shape is IAutoShape autoShape) //检查形状是否支持文本框 (IAutoShape)。
           {
              foreach (IParagraph paragraph in autoShape.TextFrame.Paragraphs) //遍历文本框中的段落
               {
                   foreach (IPortion portion in paragraph.Portions) //遍历段落中的每个部分
                   {
                       portion.Text = portion.Text.Replace("years", "months"); //更改文本
                       portion.PortionFormat.FontBold = NullableBool.True; //更改格式
                   }
               }
           }
       }
   }
  
   //保存修改后的演示文稿
   pres.Save("text-changed.pptx", SaveFormat.Pptx);
}

向文本框添加超链接

您可以在文本框内插入链接。点击文本框时，用户将打开该链接。

创建 Presentation 类的实例。
通过索引获取第一张幻灯片的引用。
在幻灯片的指定位置添加一个 AutoShape 对象，并将 ShapeType 设置为 Rectangle，然后获取新添加的 AutoShape 对象的引用。
向 AutoShape 对象添加一个 TextFrame，其默认文本为 Aspose TextBox。
实例化 IHyperlinkManager 类。
将 IHyperlinkManager 对象分配给与 TextFrame 中您首选部分关联的 HyperlinkClick 属性。
最后，通过 Presentation 对象写入 PPTX 文件。

以下 C# 代码实现了上述步骤，演示了如何向幻灯片添加带超链接的文本框：

// 实例化一个表示 PPTX 的 Presentation 类
Presentation pptxPresentation = new Presentation();

// 获取演示文稿中的第一张幻灯片
ISlide slide = pptxPresentation.Slides[0];

// 添加一个类型设置为 Rectangle 的 AutoShape 对象
IShape pptxShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

// 将形状强制转换为 AutoShape
IAutoShape pptxAutoShape = (IAutoShape)pptxShape;

// 访问与 AutoShape 关联的 ITextFrame 属性
pptxAutoShape.AddTextFrame("");

ITextFrame ITextFrame = pptxAutoShape.TextFrame;

// 向框架添加一些文本
ITextFrame.Paragraphs[0].Portions[0].Text = "Aspose.Slides";

// 为部分文本设置超链接
IHyperlinkManager HypMan = ITextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkManager;
HypMan.SetExternalHyperlinkClick("http://www.aspose.com");

// 保存 PPTX 演示文稿
pptxPresentation.Save("hLinkPPTX_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

常见问题

在使用母版幻灯片时，文本框和文本占位符有什么区别？

一个 placeholder 继承自 master 的样式/位置，并且在 layouts 上可以被覆盖，而普通的文本框是特定幻灯片上的独立对象，在切换布局时不会改变。

如何在不影响图表、表格和 SmartArt 内文本的情况下，对整个演示文稿进行批量文本替换？

将遍历范围仅限于具有文本框架的自动形状，并通过单独遍历其集合或跳过这些对象类型，来排除嵌入对象（charts、tables、SmartArt）。

在 .NET 中管理演示文稿占位符使用 .NET 中的 AutoFit 提升您的演示文稿