PHP を使用してプレゼンテーションの SmartArt シェイプノードを管理する

SmartArt ノードの追加

Aspose.Slides for PHP via Java は、SmartArt シェイプを最も簡単に管理できる API を提供しています。以下のサンプルコードは、SmartArt シェイプ内にノードと子ノードを追加する方法を示します。

Presentation クラスのインスタンスを作成し、SmartArt シェイプが含まれるプレゼンテーションをロードします。
インデックスを使用して最初のスライドへの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば選択したシェイプを SmartArt に型キャストします。
SmartArt シェイプの NodeCollection に新しいノードを Add a new Node で追加し、TextFrame にテキストを設定します。
新しく追加した SmartArt ノードに対し、Add で Child Node を作成し、TextFrame にテキストを設定します。
プレゼンテーションを保存します。

  # プレゼンテーションを読み込む
  $pres = new Presentation("SimpleSmartArt.pptx");
  try {
    # 最初のスライド内のすべてのシェイプを走査する
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {
      # シェイプが SmartArt タイプか確認する
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # シェイプを SmartArt に型キャストする
        $smart = $shape;
        # 新しい SmartArt ノードを追加する
        $TemNode = $smart->getAllNodes()->addNode();
        # テキストを設定する
        $TemNode->getTextFrame()->setText("Test");
        # 親ノードに新しい子ノードを追加する。コレクションの末尾に追加される
        $newNode = $TemNode->getChildNodes()->addNode();
        # テキストを設定する
        $newNode->getTextFrame()->setText("New Node Added");
      }
    }
    # プレゼンテーションを保存する
    $pres->save("AddSmartArtNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

特定の位置に SmartArt ノードを追加

以下のサンプルコードでは、SmartArt シェイプのそれぞれのノードに属する子ノードを指定した位置に追加する方法を説明します。

Presentation クラスのインスタンスを作成します。
インデックスを使用して最初のスライドへの参照を取得します。
アクセスしたスライドに StackedList タイプの SmartArt シェイプを追加します。
追加した SmartArt シェイプの最初のノードにアクセスします。
選択した Node の位置 2 に Child Node を追加し、テキストを設定します。
プレゼンテーションを保存します。

  # プレゼンテーションのインスタンスを作成する
  $pres = new Presentation();
  try {
    # プレゼンテーションのスライドにアクセスする
    $slide = $pres->getSlides()->get_Item(0);
    # Smart Art IShape を追加する
    $smart = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::StackedList);
    # インデックス 0 の SmartArt ノードにアクセスする
    $node = $smart->getAllNodes()->get_Item(0);
    # 親ノードの位置 2 に新しい子ノードを追加する
    $chNode = $node->getChildNodes()->addNodeByPosition(2);
    # テキストを追加する
    $chNode->getTextFrame()->setText("Sample Text Added");
    # プレゼンテーションを保存する
    $pres->save("AddSmartArtNodeByPosition.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

SmartArt ノードへのアクセス

以下のサンプルコードは、SmartArt シェイプ内のノードにアクセスする方法を示します。SmartArt の LayoutType は読み取り専用で、SmartArt シェイプを追加したときにのみ設定されることに注意してください。

Presentation クラスのインスタンスを作成し、SmartArt シェイプが含まれるプレゼンテーションをロードします。
インデックスを使用して最初のスライドへの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば選択したシェイプを SmartArt に型キャストします。
SmartArt シェイプ内のすべての Nodes を走査します。
SmartArt ノードの位置、レベル、テキストなどの情報にアクセスして表示します。

  # プレゼンテーション クラスをインスタンス化する
  $pres = new Presentation("SmartArtShape.pptx");
  try {
    # 最初のスライドを取得する
    $slide = $pres->getSlides()->get_Item(0);
    # 最初のスライド内のすべてのシェイプを走査する
    foreach($slide->getShapes() as $shape) {
      # シェイプが SmartArt タイプか確認する
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # シェイプを SmartArt に型キャストする
        $smart = $shape;
        # SmartArt 内のすべてのノードを走査する
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          # インデックス i の SmartArt ノードにアクセスする
          $node = $smart->getAllNodes()->get_Item($i);
          # SmartArt ノードのパラメータを出力する
          System->out->print($node->getTextFrame()->getText() . " " . $node->getLevel() . " " . $node->getPosition());
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

SmartArt 子ノードへのアクセス

以下のサンプルコードは、SmartArt シェイプ内の各ノードに属する子ノードにアクセスする方法を示します。

Presentation クラスのインスタンスを作成し、SmartArt シェイプが含まれるプレゼンテーションをロードします。
インデックスを使用して最初のスライドへの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば選択したシェイプを SmartArt に型キャストします。
SmartArt シェイプ内のすべての Nodes を走査します。
各 Node について、該当ノード内のすべての Child Nodes を走査します。
Child Node の位置、レベル、テキストなどの情報にアクセスして表示します。

  # Presentation クラスをインスタンス化する
  $pres = new Presentation("AccessChildNodes.pptx");
  try {
    # 最初のスライドを取得する
    $slide = $pres->getSlides()->get_Item(0);
    # 最初のスライド内のすべてのシェイプを走査する
    foreach($slide->getShapes() as $shape) {
      # シェイプが SmartArt タイプか確認する
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # シェイプを SmartArt に型キャストする
        $smart = $shape;
        # SmartArt 内のすべてのノードを走査する
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          # インデックス i の SmartArt ノードにアクセスする
          $node0 = $smart->getAllNodes()->get_Item($i);
          # インデックス i の SmartArt ノード内の子ノードを走査する
          for($j = 0; $j < java_values($node0->getChildNodes()->size()) ; $j++) {
            # SmartArt ノードの子ノードにアクセスする
            $node = $node0->getChildNodes()->get_Item($j);
            # SmartArt 子ノードのパラメータを出力する
            System->out->print("j = " . $j . ", Text = " . $node->getTextFrame()->getText() . ",  Level = " . $node->getLevel() . ", Position = " . $node->getPosition());
          }
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

特定の位置にある SmartArt 子ノードへのアクセス

この例では、SmartArt シェイプの各ノードに属する子ノードを特定の位置で取得する方法を学びます。

Presentation クラスのインスタンスを作成します。
インデックスを使用して最初のスライドへの参照を取得します。
StackedList タイプの SmartArt シェイプを追加します。
追加した SmartArt シェイプにアクセスします。
インデックス 0 のノードにアクセスします。
get_Item() メソッドを使用して、取得した SmartArt ノードの位置 1 にある Child Node にアクセスします。
Child Node の位置、レベル、テキストなどの情報にアクセスして表示します。

  # プレゼンテーションをインスタンス化する
  $pres = new Presentation();
  try {
    # 最初のスライドにアクセスする
    $slide = $pres->getSlides()->get_Item(0);
    # 最初のスライドに SmartArt シェイプを追加する
    $smart = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::StackedList);
    # インデックス 0 の SmartArt ノードにアクセスする
    $node = $smart->getAllNodes()->get_Item(0);
    # 親ノードの位置 1 の子ノードにアクセスする
    $position = 1;
    $chNode = $node->getChildNodes()->get_Item($position);
    # SmartArt 子ノードのパラメータを出力する
    System->out->print("Text = " . $chNode->getTextFrame()->getText() . ",  Level = " . $chNode->getLevel() . ", Position = " . $chNode->getPosition());
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

SmartArt ノードの削除

この例では、SmartArt シェイプ内のノードを削除する方法を学びます。

Presentation クラスのインスタンスを作成し、SmartArt シェイプが含まれるプレゼンテーションをロードします。
インデックスを使用して最初のスライドへの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば選択したシェイプを SmartArt に型キャストします。
SmartArt に 0 個以上のノードが存在するか確認します。
削除対象の SmartArt ノードを選択します。
選択したノードを removeNode メソッドで削除します。
プレゼンテーションを保存します。

  # 目的のプレゼンテーションをロードする
  $pres = new Presentation("AddSmartArtNode.pptx");
  try {
    # 最初のスライド内のすべてのシェイプを走査する
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # シェイプが SmartArt タイプか確認する
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # シェイプを SmartArt に型キャストする
        $smart = $shape;
        if (java_values($smart->getAllNodes()->size()) > 0) {
          # インデックス 0 の SmartArt ノードにアクセスする
          $node = $smart->getAllNodes()->get_Item(0);
          # 選択したノードを削除する
          $smart->getAllNodes()->removeNode($node);
        }
      }
    }
    # プレゼンテーションを保存する
    $pres->save("RemoveSmartArtNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

特定の位置にある SmartArt ノードの削除

この例では、SmartArt シェイプ内のノードを特定の位置で削除する方法を学びます。

Presentation クラスのインスタンスを作成し、SmartArt シェイプが含まれるプレゼンテーションをロードします。
インデックスを使用して最初のスライドへの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば選択したシェイプを SmartArt に型キャストします。
インデックス 0 の SmartArt シェイプノードを選択します。
選択した SmartArt ノードに 2 個以上の子ノードがあるか確認します。
Position 1 のノードを removeNode メソッドで削除します。
プレゼンテーションを保存します。

  # 目的のプレゼンテーションをロードする
  $pres = new Presentation("AddSmartArtNode.pptx");
  try {
    # 最初のスライド内のすべてのシェイプを走査する
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # シェイプが SmartArt タイプか確認する
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # シェイプを SmartArt に型キャストする
        $smart = $shape;
        if (java_values($smart->getAllNodes()->size()) > 0) {
          # インデックス 0 の SmartArt ノードにアクセスする
          $node = $smart->getAllNodes()->get_Item(0);
          if (java_values($node->getChildNodes()->size()) >= 2) {
            # 位置 1 の子ノードを削除する
            $node->getChildNodes()->removeNode(1);
          }
        }
      }
    }
    # プレゼンテーションを保存する
    $pres->save("RemoveSmartArtNodeByPosition.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

SmartArt オブジェクト内の子ノードにカスタム位置を設定

Aspose.Slides for PHP via Java は、SmartArtShape の X および Y プロパティの設定をサポートします。以下のコードスニペットは、カスタムの SmartArtShape 位置、サイズ、回転を設定する方法を示します。新しいノードを追加すると、すべてのノードの位置とサイズが再計算されることに注意してください。カスタム位置設定により、ユーザーは要件に合わせてノードを配置できます。

  # Presentation クラスをインスタンス化する
  $pres = new Presentation("SimpleSmartArt.pptx");
  try {
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(20, 20, 600, 500, SmartArtLayoutType::OrganizationChart);
    # SmartArt シェイプを新しい位置に移動する
    $node = $smart->getAllNodes()->get_Item(1);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setX($shape->getX() . $shape->getWidth() * 2);
    $shape->setY($shape->getY() - $shape->getHeight() * 2);
    # SmartArt シェイプの幅を変更する
    $node = $smart->getAllNodes()->get_Item(2);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setWidth($shape->getWidth() . $shape->getWidth() * 2);
    # SmartArt シェイプの高さを変更する
    $node = $smart->getAllNodes()->get_Item(3);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setHeight($shape->getHeight() . $shape->getHeight() * 2);
    # SmartArt シェイプの回転を変更する
    $node = $smart->getAllNodes()->get_Item(4);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setRotation(90);
    $pres->save("SmartArt.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

アシスタントノードの確認

この記事では、Aspose.Slides for PHP via Java を使用してプログラムでプレゼンテーションスライドに追加された SmartArt シェイプの機能をさらに調査します。

調査に使用する SmartArt シェイプは、この記事の各セクションで使用します。


Figure: ソース SmartArt シェイプ（スライド）

以下のサンプルコードでは、SmartArt ノードコレクション内の Assistant Nodes を特定し、変更する方法を調査します。

Presentation クラスのインスタンスを作成し、SmartArt シェイプが含まれるプレゼンテーションをロードします。
インデックスを使用して 2 番目のスライドへの参照を取得します。
最初のスライド内のすべてのシェイプを走査します。
シェイプが SmartArt タイプか確認し、SmartArt であれば選択したシェイプを SmartArt に型キャストします。
SmartArt シェイプ内のすべてのノードを走査し、Assistant Nodes かどうかを確認します。
アシスタントノードのステータスを通常のノードに変更します。
プレゼンテーションを保存します。

  # プレゼンテーション インスタンスを作成する
  $pres = new Presentation("AddNodes.pptx");
  try {
    # 最初のスライド内のすべてのシェイプを走査する
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # シェイプが SmartArt タイプか確認する
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # シェイプを SmartArt に型キャストする
        $smart = $shape;
        # SmartArt シェイプのすべてのノードを走査する
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          $node = $smart->getAllNodes()->get_Item($i);
          # ノードがアシスタントノードか確認する
          if ($node->isAssistant()) {
            # アシスタントノードを false に設定し、通常ノードにする
            $node->isAssistant();
          }
        }
      }
    }
    # プレゼンテーションを保存する
    $pres->save("ChangeAssitantNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }


Figure: スライド内 SmartArt シェイプで変更されたアシスタントノード

ノードの塗りつぶし形式の設定

Aspose.Slides for PHP via Java を使用すると、カスタム SmartArt シェイプを追加し、その塗りつぶし形式を設定できます。本記事では、SmartArt シェイプの作成とアクセス、および塗りつぶし形式の設定方法を説明します。

以下の手順に従ってください。

Presentation クラスのインスタンスを作成します。
インデックスを使用してスライドへの参照を取得します。
LayoutType を設定して SmartArt シェイプを追加します。
SmartArt シェイプのノードに対して Fill Format を設定します。
変更したプレゼンテーションを PPTX ファイルとして書き出します。

  # プレゼンテーションをインスタンス化する
  $pres = new Presentation();
  try {
    # スライドにアクセスする
    $slide = $pres->getSlides()->get_Item(0);
    # SmartArt シェイプとノードを追加する
    $chevron = $slide->getShapes()->addSmartArt(10, 10, 800, 60, SmartArtLayoutType::ClosedChevronProcess);
    $node = $chevron->getAllNodes()->addNode();
    $node->getTextFrame()->setText("Some text");
    # ノードの塗りつぶし色を設定する
    foreach($node->getShapes() as $item) {
      $item->getFillFormat()->setFillType(FillType::Solid);
      $item->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    }
    # プレゼンテーションを保存する
    $pres->save("TestSmart.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

SmartArt 子ノードのサムネイル生成

開発者は以下の手順で SmartArt の子ノードのサムネイルを生成できます。

Presentation クラスのインスタンスを作成します。
Add SmartArt を実行します。
インデックスを使用してノードへの参照を取得します。
サムネイル画像を取得します。
任意の画像フォーマットでサムネイル画像を保存します。

  # PPTX ファイルを表す Presentation クラスをインスタンス化する
  $pres = new Presentation();
  try {
    # SmartArt を追加する
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicCycle);
    # インデックスを使用してノードの参照を取得する
    $node = $smart->getNodes()->get_Item(1);
    # サムネイルを取得する
    $slideImage = $node->getShapes()->get_Item(0)->getImage();
    # サムネイルを保存する
    try {
      $slideImage->save("SmartArt_ChildNote_Thumbnail.png", ImageFormat::Png);
    } finally {
      if (!java_is_null($slideImage)) {
        $slideImage->dispose();
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

SmartArt アニメーションはサポートされていますか？

はい。SmartArt は通常のシェイプとして扱われるため、標準アニメーション（入場、退場、強調、動きの経路）を適用したり、タイミングを調整したりできます。必要に応じて SmartArt ノード内のシェイプにもアニメーションを付与できます。

スライド上で内部 ID が不明な特定の SmartArt を確実に見つける方法は？

代替テキストを設定し、検索します。SmartArt に固有の AltText を付与すれば、内部識別子に依存せずプログラムから取得できます。

プレゼンテーションを PDF に変換するとき、SmartArt の外観は保持されますか？

はい。Aspose.Slides は PDF エクスポート時に SmartArt を高い視覚忠実度で描画し、レイアウト、色、効果を保持します。

SmartArt 全体の画像を抽出してプレビューやレポートに利用できますか？

はい。SmartArt シェイプをラスタ形式または SVG にレンダリングでき、サムネイル、レポート、Web 用の画像として利用可能です。

  # プレゼンテーションをインスタンス化する
  $pres = new Presentation();
  try {
    # スライドにアクセスする
    $slide = $pres->getSlides()->get_Item(0);
    # SmartArt シェイプとノードを追加する
    $chevron = $slide->getShapes()->addSmartArt(10, 10, 800, 60, SmartArtLayoutType::ClosedChevronProcess);
    $node = $chevron->getAllNodes()->addNode();
    $node->getTextFrame()->setText("Some text");
    # ノードの塗りつぶし色を設定する
    foreach($node->getShapes() as $item) {
      $item->getFillFormat()->setFillType(FillType::Solid);
      $item->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    }
    # プレゼンテーションを保存する
    $pres->save("TestSmart.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

PHP を使用してプレゼンテーションの SmartArt グラフィックスを管理する

PHP を使用してプレゼンテーションの SmartArt シェイプ ノードを管理する