管理文本框

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

信息

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

注意

因此，当处理要添加文本的形状时，您可能希望检查并确认它是通过 IAutoShape 接口进行类型转换的。只有这样，您才能使用 TextFrame，这是 IAutoShape 下的一个属性。请参见此页面上的更新文本部分。

在幻灯片上创建文本框

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

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

以下 PHP 代码—对上述步骤的实现—向您展示了如何在幻灯片上添加文本：

  # 实例化 Presentation
  $pres = new Presentation();
  try {
    # 获取演示文稿中的第一张幻灯片
    $sld = $pres->getSlides()->get_Item(0);
    # 添加类型设置为 Rectangle 的 AutoShape
    $ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
    # 向矩形添加 TextFrame
    $ashp->addTextFrame(" ");
    # 访问文本框
    $txtFrame = $ashp->getTextFrame();
    # 为文本框创建段落对象
    $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 提供了 isTextBox() 属性（来自 AutoShape 类），允许您检查形状并找到文本框。

文本框和形状

以下 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()) ? "形状是文本框" : "形状不是文本框");
    }
}

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

在文本框中添加列

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

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

  $pres = new Presentation();
  try {
    # 获取演示文稿中的第一张幻灯片
    $slide = $pres->getSlides()->get_Item(0);
    # 添加类型设置为 Rectangle 的 AutoShape
    $aShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    # 向矩形添加 TextFrame
    $aShape->addTextFrame("所有这些列都限制在单个文本容器内--您可以添加或删除文本，新文本或剩余文本会自动调整自身以适应容器。然而，文本无法从一个容器流动到另一个容器，因为我们告诉过您 PowerPoint 的文本列选项是有限的！");
    # 获取 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("所有这些列都被强制保留在单个文本容器内--您可以添加或删除文本，新的或剩余的文本会自动调整以保持在容器内。然而，文本不能溢出至其他容器，因为 PowerPoint 的文本列选项是有限的！");
    $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) {
            # 迭代段落中的每个部分
            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 类的实例。
获取新创建的演示文稿的第一张幻灯片的引用。
添加一个 ShapeType 设置为 Rectangle 的 AutoShape 对象，并获取新添加的 AutoShape 对象的引用。
向 AutoShape 对象添加一个默认文本为 Aspose TextBox 的 TextFrame。
实例化 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");
    # 为部分文本设置超链接
    $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();
    }
  }

管理占位符管理自动调整设置