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

このページの概要

Aspose.Slides for Python via Java を使用して PPT および PPTX の SmartArt シェイプノードを管理します。コードサンプルとヒントでプレゼンテーションを効率化してください。

概要

PowerPoint のプレゼンテーションにおける SmartArt グラフィックは、テキストを含むノードで構成され、図の構造を定義します。Aspose.Slides を使用すると、これらの SmartArt ノードをプログラムで操作できます。新しいノードや子ノードの追加、特定の位置への子ノードの挿入、既存ノードへのアクセス、テキスト、レベル、位置の取得が可能です。

この記事では、SmartArt シェイプノードの管理方法について説明します。ノードの削除、インデックスまたは位置による子ノードの操作、アシスタントノードを通常ノードに変更、SmartArt ノードシェイプの位置・サイズ・回転の調整、ノードの塗りつぶし形式の設定、SmartArt 子ノードのサムネイル画像生成方法を示します。

SmartArt ノードの追加

Aspose.Slides for Python via Java は SmartArt シェイプを管理する API を提供します。以下の例は、SmartArt シェイプにノードと子ノードを追加します。

SmartArt シェイプを含むプレゼンテーションを読み込むために、プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
最初のスライド上のすべてのシェイプを反復処理します。
シェイプが SmartArt インスタンスかどうか確認します。
新しいノードを追加して、SmartArt シェイプのノードコレクションに追加し、TextFrame を介してテキストを設定します。
追加 a 子ノードを新しいノードに追加し、TextFrame を介してテキストを設定します。
プレゼンテーションを保存します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("SimpleSmartArt.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            node = smart_art.getAllNodes().addNode()
            node.getTextFrame().setText("Test")
            child_node = node.getChildNodes().addNode()
            child_node.getTextFrame().setText("New Node Added")
    presentation.save("AddSmartArtNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

以下の例は、SmartArt ノード内の特定の位置に子ノードを追加します。

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

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)
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList)
    node = smart_art.getAllNodes().get_Item(0)
    child_node = node.getChildNodes().addNodeByPosition(2)
    child_node.getTextFrame().setText("Sample Text Added")
    presentation.save("AddSmartArtNodeByPosition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

SmartArt ノードへのアクセス

以下の例は、SmartArt シェイプ内のノードにアクセスします。getLayout が返すレイアウトは読み取り専用で、SmartArt シェイプが追加されたときに設定されます。

SmartArt シェイプを含むプレゼンテーションを読み込むために、プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
最初のスライド上のすべてのシェイプを反復処理します。
シェイプが SmartArt インスタンスかどうか確認します。
SmartArt シェイプ内のすべてのノードを反復処理します。
各 SmartArt ノードの位置、レベル、テキストを読み取り表示します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("SmartArtShape.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                node = smart_art.getAllNodes().get_Item(i)
                print(node.getTextFrame().getText(), " ", node.getLevel(), " ", node.getPosition())
finally:
    presentation.dispose()

SmartArt 子ノードへのアクセス

以下の例は、SmartArt シェイプ内の各ノードの子ノードにアクセスします。

SmartArt シェイプを含むプレゼンテーションを読み込むために、プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
最初のスライド上のすべてのシェイプを反復処理します。
シェイプが SmartArt インスタンスかどうか確認します。
SmartArt シェイプ内のすべてのノードを反復処理します。
各ノードについて、その子ノードを反復処理します。
子ノードの位置、レベル、テキストを読み取り表示します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessChildNodes.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                parent_node = smart_art.getAllNodes().get_Item(i)
                for j in range(parent_node.getChildNodes().size()):
                    node = parent_node.getChildNodes().get_Item(j)
                    print("j = ", j, ", Text = ", node.getTextFrame().getText(), ",  Level = ", node.getLevel(), ", Position = ", node.getPosition())
finally:
    presentation.dispose()

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

以下の例は、親ノードのコレクション内で特定のインデックスにある子ノードにアクセスします。

プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
StackedList レイアウトの SmartArt シェイプを追加します。
追加した SmartArt シェイプにアクセスします。
SmartArt シェイプ内のインデックス 0 のノードにアクセスします。
get_Item を使用してインデックス 1 の子ノードにアクセスします。
子ノードの位置、レベル、テキストを読み取り表示します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArtLayoutType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList)
    node = smart_art.getAllNodes().get_Item(0)
    position = 1
    child_node = node.getChildNodes().get_Item(position)
    print("Text = ", child_node.getTextFrame().getText(), ",  Level = ", child_node.getLevel(), ", Position = ", child_node.getPosition())
finally:
    presentation.dispose()

SmartArt ノードの削除

以下の例は、SmartArt シェイプからノードを削除します。

SmartArt シェイプを含むプレゼンテーションを読み込むために、プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
最初のスライド上のすべてのシェイプを反復処理します。
シェイプが SmartArt インスタンスかどうか確認します。
SmartArt シェイプに少なくとも 1 つのノードが含まれていることを確認します。
削除する SmartArt ノードを選択します。
removeNode を使用して選択したノードを削除します。
プレゼンテーションを保存します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddSmartArtNode.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            if smart_art.getAllNodes().size() > 0:
                node = smart_art.getAllNodes().get_Item(0)
                smart_art.getAllNodes().removeNode(node)
    presentation.save("RemoveSmartArtNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

以下の例は、SmartArt ノードのコレクション内で特定のインデックスにある子ノードを削除します。

SmartArt シェイプを含むプレゼンテーションを読み込むために、プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
最初のスライド上のすべてのシェイプを反復処理します。
シェイプが SmartArt インスタンスかどうか確認します。
インデックス 0 の SmartArt ノードが存在すればアクセスします。
選択した SmartArt ノードが少なくとも 2 つの子ノードを持っていることを確認します。
removeNode を使用してインデックス 1 の子ノードを削除します。
プレゼンテーションを保存します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddSmartArtNode.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            if smart_art.getAllNodes().size() > 0:
                node = smart_art.getAllNodes().get_Item(0)
                if node.getChildNodes().size() >= 2:
                    node.getChildNodes().removeNode(1)
    presentation.save("RemoveSmartArtNodeByPosition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

Aspose.Slides for Python via Java は、SmartArtShape の位置を setX と setY で設定することをサポートします。以下の例は、SmartArt ノードシェイプのカスタム位置、サイズ、回転を設定します。新しいノードを追加すると、すべてのノードの位置とサイズが再計算されます。カスタム位置指定により、必要に応じてノードを配置できます。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    smart_art = presentation.getSlides().get_Item(0).getShapes().addSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart)
    node = smart_art.getAllNodes().get_Item(1)
    shape = node.getShapes().get_Item(1)
    shape.setX(shape.getX() + shape.getWidth() * 2)
    shape.setY(shape.getY() - shape.getHeight() * 2)
    node = smart_art.getAllNodes().get_Item(2)
    shape = node.getShapes().get_Item(1)
    shape.setWidth(shape.getWidth() + shape.getWidth() * 2)
    node = smart_art.getAllNodes().get_Item(3)
    shape = node.getShapes().get_Item(1)
    shape.setHeight(shape.getHeight() + shape.getHeight() * 2)
    node = smart_art.getAllNodes().get_Item(4)
    shape = node.getShapes().get_Item(1)
    shape.setRotation(90)
    presentation.save("SmartArt.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

Note

このセクションでは、Aspose.Slides for Python via Java を使用してプログラムからプレゼンテーションスライドに追加された SmartArt シェイプを検証します。

以下のソース SmartArt シェイプが例で使用されます。


図: スライド上のソース SmartArt シェイプ

以下の例は、SmartArt ノードコレクション内のアシスタントノードを特定し、通常ノードに変更します。

SmartArt シェイプを含むプレゼンテーションを読み込むために、プレゼンテーションクラスのインスタンスを作成します。
インデックスで最初のスライドを取得します。
最初のスライド上のすべてのシェイプを反復処理します。
シェイプが SmartArt インスタンスかどうか確認します。
SmartArt シェイプ内のすべてのノードを反復処理し、Assistant Nodes かどうかチェックします。
各アシスタントノードを通常ノードに変更します。
プレゼンテーションを保存します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddNodes.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                node = smart_art.getAllNodes().get_Item(i)
                if node.isAssistant():
                    node.setAssistant(False)
    presentation.save("ChangeAssistantNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


図: スライド上の SmartArt シェイプでアシスタントノードが変更された様子

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

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

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

プレゼンテーションクラスのインスタンスを作成します。
インデックスでスライドを取得します。
ClosedChevronProcess レイアウトの SmartArt シェイプを追加します。
SmartArt シェイプノードの FillFormat を設定します。
変更したプレゼンテーションを PPTX ファイルとして書き出します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType, FillType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chevron = slide.getShapes().addSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess)
    node = chevron.getAllNodes().addNode()
    node.getTextFrame().setText("Some text")
    for item in node.getShapes():
        item.getFillFormat().setFillType(FillType.Solid)
        item.getFillFormat().getSolidFillColor().setColor(Color.RED)
    presentation.save("TestSmart.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

SmartArt 子ノードのサムネイルを生成する手順は次のとおりです。

プレゼンテーションクラスのインスタンスを作成します。
SmartArt シェイプを追加します。
インデックスでノードを取得します。
サムネイル画像を取得します。
任意の画像形式でサムネイル画像を保存します。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArtLayoutType, ImageFormat

presentation = Presentation()
try:
    smart_art = presentation.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle)
    node = smart_art.getNodes().get_Item(1)
    image = node.getShapes().get_Item(0).getImage()
    try:
        image.save("SmartArt_ChildNode_Thumbnail.png", ImageFormat.Png)
    finally:
        image.dispose()
finally:
    presentation.dispose()

FAQ

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

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

内部 ID が不明な場合、スライド上の特定の SmartArt を確実に見つける方法はありますか？

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

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

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

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

はい。SmartArt シェイプをラスタ形式または SVG にレンダリングでき、サムネイル、レポート、Web 用に適した形式で取得できます。

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

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