PHP を使用したプレゼンテーション内のテキストボックス管理

スライド上のテキストは通常、テキストボックスまたはシェイプに存在します。そのため、スライドにテキストを追加するには、テキストボックスを追加し、そのテキストボックスにテキストを入れる必要があります。Aspose.Slides for PHP via Java は、テキストを含むシェイプを追加できる IAutoShape インターフェイスを提供しています。

Info

Aspose.Slides には、スライドにシェイプを追加できる IShape インターフェイスも用意されています。ただし、IShape インターフェイスで追加したすべてのシェイプがテキストを保持できるわけではありません。[IAutoShape](https://reference.aspose.com/slides/php-java/aspose.slides/IAutoShape) インターフェイスで追加したシェイプはテキストを含むことができます。

Note

したがって、テキストを追加したいシェイプを扱う場合は、まずそのシェイプが IAutoShape インターフェイスにキャストされているか確認してください。IAutoShape の下にあるプロパティ TextFrame を使用できるようになるからです。このページの Update Text セクションをご参照ください。

Create a Text Box on a Slide

テキストボックスをスライドに作成する手順は次のとおりです。

Presentation クラスのインスタンスを作成します。
新しく作成したプレゼンテーションの最初のスライドへの参照を取得します。
スライド上の指定位置に Rectangle として ShapeType を設定した IAutoShape オブジェクトを追加し、追加された IAutoShape オブジェクトへの参照を取得します。
テキストを含む TextFrame プロパティを IAutoShape オブジェクトに追加します。以下の例では、Aspose TextBox というテキストを追加しています。
最後に Presentation オブジェクトを使って PPTX ファイルを書き出します。

以下の PHP コードは、上記手順の実装例で、スライドにテキストを追加する方法を示しています:

  # プレゼンテーションをインスタンス化
  $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();
    # テキストフレーム用の Paragraph オブジェクトを作成
    $para = $txtFrame->getParagraphs()->get_Item(0);
    # Paragraph 用の 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();
    }
  }

Check for a Text Box Shape

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();
}

addAutoShape メソッド（ShapeCollection クラス）で単にオートシェイプを追加した場合、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 を返します

Add Columns to a Text Box

Aspose.Slides は、ITextFrameFormat インターフェイスおよび TextFrameFormat クラスの ColumnCount と ColumnSpacing プロパティを提供しており、テキストボックスに列を追加できます。列数と列間のポイント単位の間隔を設定できます。

以下のコードは、上記操作を実演したものです:

  $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("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();
    }
  }

Add Columns to a Text Frame

Aspose.Slides for PHP via Java は、ITextFrameFormat インターフェイスの ColumnCount プロパティを提供しており、テキストフレーム内に列を追加できます。このプロパティを使用して、テキストフレーム内の列数を指定できます。

この 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();
    }
  }

Update Text

Aspose.Slides を使用すると、テキストボックス内のテキストやプレゼンテーション全体に含まれるテキストを変更または更新できます。

以下の PHP コードは、プレゼンテーション内のすべてのテキストを更新（変更）する操作例です:

  $pres = new Presentation("text.pptx");
  try {
    foreach($pres->getSlides() as $slide) {
      foreach($slide->getShapes() as $shape) {
        # 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();
    }
  }

Add a Text Box with a Hyperlink

テキストボックス内にリンクを挿入できます。テキストボックスがクリックされると、ユーザーはリンク先へ移動します。

テキストボックスにリンクを含める手順は次のとおりです。

Presentation クラスのインスタンスを作成します。
新しく作成したプレゼンテーションの最初のスライドへの参照を取得します。
スライド上の指定位置に Rectangle として ShapeType を設定した AutoShape オブジェクトを追加し、追加された AutoShape オブジェクトへの参照を取得します。
AutoShape オブジェクトに TextFrame を追加し、デフォルトテキストとして Aspose TextBox を設定します。
IHyperlinkManager クラスのインスタンスを作成します。
TextFrame の対象部分に対し、IHyperlinkManager オブジェクトを 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();
    }
  }

FAQ

マスタースライドでテキストボックスとテキストプレースホルダーの違いは何ですか？

プレースホルダー（placeholder）は、マスタからスタイル/位置を継承し、レイアウトでオーバーライド可能です。一方、通常のテキストボックスは特定のスライド上の独立オブジェクトであり、レイアウトを切り替えても変わりません。

チャート、テーブル、SmartArt 内のテキストを除外して、プレゼンテーション全体でテキストを一括置換するにはどうすればよいですか？

テキストフレームを持つオートシェイプだけを対象に反復処理し、埋め込みオブジェクト（チャート、テーブル、SmartArt）はそれぞれのコレクションを別途走査するか、対象タイプから除外してください。

PHPでプレゼンテーションのプレースホルダーを管理 PHP で AutoFit を使用してプレゼンテーションを強化する