Python を使用したプレゼンテーションにおける SmartArt グラフィックの管理

概要

Aspose.Slides を使用すると、PowerPoint プレゼンテーションで SmartArt グラフィックをプログラムで作成および管理できます。この記事では、スライドに SmartArt シェイプを追加し、既存の SmartArt シェイプにアクセスし、特定のレイアウトタイプで SmartArt を検索し、SmartArt スタイルまたは配色スタイルを変更して外観を更新する方法を説明します。

例では、プレゼンテーション スライドのシェイプ コレクションを介して SmartArt シェイプを操作し、シェイプが SmartArt かどうかを確認してからプロパティを変更または検査する方法を示します。

SmartArt シェイプの作成

Aspose.Slides for Python via Java は SmartArt シェイプを作成する API を提供します。スライドに SmartArt シェイプを作成するには、以下の手順に従ってください。

  1. Presentation クラスのインスタンスを作成します。
  2. インデックスでスライドを取得します。
  3. SmartArtLayoutType を指定して Add a SmartArt shape を呼び出します。
  4. 変更したプレゼンテーションを PPTX ファイルとして保存します。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation()
try:
    # 最初のスライドを取得します。
    slide = presentation.getSlides().get_Item(0)

    # SmartArt シェイプを追加します。
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.BasicBlockList)

    # プレゼンテーションを保存します。
    presentation.save("SimpleSmartArt.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
SmartArt shape
図: スライドに追加された SmartArt シェイプ

スライド上の SmartArt シェイプへのアクセス

以下の例は、プレゼンテーション スライド上の SmartArt シェイプにアクセスします。スライド上のすべてのシェイプを反復処理し、シェイプが SmartArt インスタンスかどうかをチェックします。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # 最初のスライド上のすべてのシェイプを反復処理します。
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            print("Shape Name: " + str(smart_art.getName()))
finally:
    presentation.dispose()

特定のレイアウトタイプを持つ SmartArt シェイプへのアクセス

以下の例は、SmartArt.getLayout が返す特定のレイアウトタイプを持つ SmartArt シェイプにアクセスします。

  1. Presentation のインスタンスを作成し、SmartArt シェイプを含むプレゼンテーションをロードします。
  2. インデックスで最初のスライドを取得します。
  3. 最初のスライド上のすべてのシェイプを反復処理します。
  4. シェイプが SmartArt インスタンスかどうかを確認します。
  5. SmartArt シェイプが指定されたレイアウトタイプを持つかどうかをチェックし、必要な操作を実行します。
import jpide
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt, SmartArtLayoutType

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # 最初のスライド上のすべてのシェイプを反復処理します。
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # SmartArt のレイアウトを確認します。
            if smart_art.getLayout() == SmartArtLayoutType.BasicBlockList:
                print("Perform the required operation here.")
finally:
    presentation.dispose()

SmartArt シェイプのスタイル変更

この例は、SmartArt シェイプのクイック スタイルを変更する方法を示します。

  1. Presentation のインスタンスを作成し、SmartArt シェイプを含むプレゼンテーションをロードします。
  2. インデックスで最初のスライドを取得します。
  3. 最初のスライド上のすべてのシェイプを反復処理します。
  4. シェイプが SmartArt インスタンスかどうかを確認します。
  5. 指定されたスタイルを持つ SmartArt シェイプを検索します。
  6. SmartArt シェイプに新しいスタイルを設定します。
  7. プレゼンテーションを保存します。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtQuickStyleType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # 最初のスライド上のすべてのシェイプを反復処理します。
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # SmartArt のスタイルを確認し、変更します。
            if smart_art.getQuickStyle() == SmartArtQuickStyleType.SimpleFill:
                smart_art.setQuickStyle(SmartArtQuickStyleType.Cartoon)

    presentation.save("ChangeSmartArtStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
SmartArt shape
図: スタイルが変更された SmartArt シェイプ

SmartArt シェイプの配色スタイル変更

この例は、特定の配色スタイルを持つ SmartArt シェイプにアクセスし、そのスタイルを変更します。

  1. Presentation のインスタンスを作成し、SmartArt シェイプを含むプレゼンテーションをロードします。
  2. インデックスで最初のスライドを取得します。
  3. 最初のスライド上のすべてのシェイプを反復処理します。
  4. シェイプが SmartArt インスタンスかどうかを確認します。
  5. 指定された配色スタイルを持つ SmartArt シェイプを検索します。
  6. SmartArt シェイプに新しい配色スタイルを設定します。
  7. プレゼンテーションを保存します。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtColorType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # 最初のスライド上のすべてのシェイプを反復処理します。
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # SmartArt のスタイルを確認し、変更します。
            if smart_art.getColorStyle() == SmartArtColorType.ColoredFillAccent1:
                smart_art.setColorStyle(SmartArtColorType.ColorfulAccentColors)

    presentation.save("ChangeSmartArtColorStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
SmartArt shape
図: 配色スタイルが変更された SmartArt シェイプ

よくある質問

SmartArt を単一オブジェクトとしてアニメーション化できますか？

はい。SmartArt はシェイプなので、他のシェイプと同様にアニメーション API（開始、終了、強調、動きのパス）を使用して 標準アニメーション を適用できます。

内部 ID が分からない場合、スライド上の特定の SmartArt をどうやって見つけますか？

代替テキスト を設定してその値でシェイプを検索します。これが推奨される方法です。

SmartArt を他のシェイプとグループ化できますか？

はい。SmartArt を画像やテーブルなどの他のシェイプとグループ化でき、その後 グループを操作 できます。

特定の SmartArt の画像（プレビューやレポート用）を取得するには？

シェイプのサムネイル/画像をエクスポートします。ライブラリは個々のシェイプを Raster ファイル (PNG/JPG/TIFF) にレンダリング できます。

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

はい。レンダリング エンジンは PDF エクスポート において高忠実度を目指しており、品質と互換性のオプションが多数用意されています。

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