使用 PHP 管理演示文稿中的文本框

幻灯片上的文本通常位于文本框或形状中。因此，要向幻灯片添加文本，需要先添加一个文本框，然后在文本框内放入一些文本。Aspose.Slides for PHP via Java 提供了 IAutoShape 接口，允许您添加包含文本的形状。

Info

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

Note

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

在幻灯片上创建文本框

要在幻灯片上创建文本框，请按以下步骤操作：

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

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

  # 实例化 Presentation
  $pres = new Presentation();
  try {
    # 获取演示文稿中的第一张幻灯片
    $sld = $pres->getSlides()->get_Item(0);
    # 添加 AutoShape，类型设置为 Rectangle
    $ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
    # 向矩形添加 TextFrame
    $ashp->addTextFrame(" ");
    # 访问文本框架
    $txtFrame = $ashp->getTextFrame();
    # 为文本框创建 Paragraph 对象
    $para = $txtFrame->getParagraphs()->get_Item(0);
    # 为段落创建 Portion 对象
    $portion = $para->getPortions()->get_Item(0);
    # 设置文本
    $portion->setText("Aspose TextBox");
    # 将演示文稿保存到磁盘
    $pres->save("TextBox_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

检查文本框形状

Aspose.Slides 在 AutoShape 类中提供了 isTextBox 方法，允许您检查形状并识别文本框。

Text box and shape

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

class ShapeCallback {
    function invoke($shape, $slide, $index) {
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
            $autoShape = $shape;
            echo(java_is_true($autoShape->isTextBox()) ? "shape is a text box" : "shape is not a text box");
        }
    }
}

$presentation = new Presentation("sample.pptx");
try {
    $forEachShapeCallback = java_closure(new ShapeCallback(), null, java("com.aspose.slides.ForEachSlideCallback"));
    ForEach::shape($presentation, $forEachShapeCallback);
} finally {
    $presentation->dispose();
}

请注意，如果仅使用 ShapeCollection 类的 addAutoShape 方法添加自动形状，则该自动形状的 isTextBox 方法将返回 false。但是，在使用 addTextFrame 方法或 setText 方法向自动形状添加文本后，isTextBox 属性将返回 true。

$presentation = new Presentation();
$slide = $presentation->getSlides()->get_Item(0);

$shape1 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 100, 40); // shape1->isTextBox() 返回 false
$shape1->addTextFrame("shape 1"); // shape1->isTextBox() 返回 true

$shape2 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 110, 100, 40); // shape2->isTextBox() 返回 false
$shape2->getTextFrame()->setText("shape 2"); // shape2->isTextBox() 返回 true

$shape3 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 210, 100, 40); // shape3->isTextBox() 返回 false
$shape3->addTextFrame(""); // shape3->isTextBox() 返回 false

$shape4 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 310, 100, 40); // shape4->isTextBox() 返回 false
$shape4->getTextFrame()->setText(""); // shape4->isTextBox() 返回 false

向文本框添加列

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

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

  $pres = new Presentation();
  try {
    # 获取演示文稿中的第一张幻灯片
    $slide = $pres->getSlides()->get_Item(0);
    # 添加 AutoShape，类型设置为 Rectangle
    $aShape = $slide->getShapes()->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 的文本格式
    $format = $aShape->getTextFrame()->getTextFrameFormat();
    # 指定 TextFrame 的列数
    $format->setColumnCount(3);
    # 指定列之间的间距
    $format->setColumnSpacing(10);
    # 保存演示文稿
    $pres->save("ColumnCount.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

向文本框架添加列

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

以下 PHP 代码演示了如何在文本框架中添加列：

  $outPptxFileName = "ColumnsTest.pptx";
  $pres = new Presentation();
  try {
    $shape1 = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    $format = $shape1->getTextFrame()->getTextFrameFormat();
    $format->setColumnCount(2);
    $shape1->getTextFrame()->setText("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);
    $test = new Presentation($outPptxFileName);
    try {
      $autoShape = $test->getSlides()->get_Item(0)->getShapes()->get_Item(0);
      Assert->assertTrue(2 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnCount());
      Assert->assertTrue(Double->NaN == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnSpacing());
    } finally {
      if (!java_is_null($test)) {
        $test->dispose();
      }
    }
    $format->setColumnSpacing(20);
    $pres->save($outPptxFileName, SaveFormat::Pptx);
    $test1 = new Presentation($outPptxFileName);
    try {
      $autoShape = $test1->getSlides()->get_Item(0)->getShapes()->get_Item(0);
      Assert->assertTrue(2 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnCount());
      Assert->assertTrue(20 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnSpacing());
    } finally {
      if (!java_is_null($test1)) {
        $test1->dispose();
      }
    }
    $format->setColumnCount(3);
    $format->setColumnSpacing(15);
    $pres->save($outPptxFileName, SaveFormat::Pptx);
    $test2 = new Presentation($outPptxFileName);
    try {
      $autoShape = $test2->getSlides()->get_Item(0)->getShapes()->get_Item(0);
      Assert->assertTrue(3 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnCount());
      Assert->assertTrue(15 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnSpacing());
    } finally {
      if (!java_is_null($test2)) {
        $test2->dispose();
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

更新文本

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

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

  $pres = new Presentation("text.pptx");
  try {
    foreach($pres->getSlides() as $slide) {
      foreach($slide->getShapes() as $shape) {
        # 检查形状是否支持文本框架 (IAutoShape)。
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
          $autoShape = $shape;
          # 遍历文本框中的段落
          foreach($autoShape->getTextFrame()->getParagraphs() as $paragraph) {
            # 遍历段落中的每个 Portion
            foreach($paragraph->getPortions() as $portion) {
              $portion->setText($portion->getText()->replace("years", "months"));// 更改文本

              $portion->getPortionFormat()->setFontBold(NullableBool::True);// 更改格式

            }
          }
        }
      }
    }
    # 保存修改后的演示文稿
    $pres->save("text-changed.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

向文本框添加超链接

您可以在文本框中插入链接。单击文本框时，用户将被引导打开该链接。

要添加包含链接的文本框，请按以下步骤操作：

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

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

  # 实例化一个表示 PPTX 的 Presentation 类
  $pres = new Presentation();
  try {
    # 获取演示文稿中的第一张幻灯片
    $slide = $pres->getSlides()->get_Item(0);
    # 添加一个类型设置为 Rectangle 的 AutoShape 对象
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 150, 150, 50);
    # 将形状强制转换为 AutoShape
    $pptxAutoShape = $shape;
    # 访问与 AutoShape 关联的 ITextFrame 属性
    $pptxAutoShape->addTextFrame("");
    $textFrame = $pptxAutoShape->getTextFrame();
    # 向框中添加一些文本
    $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->setText("Aspose.Slides");
    # 为该 Portion 文本设置超链接
    $hyperlinkManager = $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->getHyperlinkManager();
    $hyperlinkManager->setExternalHyperlinkClick("http://www.aspose.com");
    # 保存 PPTX 演示文稿
    $pres->save("hLink_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

常见问题

在使用母版幻灯片时，文本框和文本占位符有什么区别？
占位符 placeholder 继承自母版的样式/位置，并且可以在布局上覆盖，而普通文本框是特定幻灯片上的独立对象，切换布局时不会改变。

如何在演示文稿中批量替换文本而不影响图表、表格和 SmartArt 中的文本？
将遍历范围限制在具有文本框架的自动形状上，并通过分别遍历或跳过嵌入对象（图表、表格、SmartArt）来排除这些对象类型。

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