SmartArt‑Formknoten in Präsentationen mit Python verwalten

Worum es auf dieser Seite geht

Verwalten Sie SmartArt‑Formknoten in PPT und PPTX mit Aspose.Slides für Python via Java. Erhalten Sie klare Code‑Beispiele und Tipps, um Ihre Präsentationen zu optimieren.

Übersicht

SmartArt‑Grafiken in PowerPoint‑Präsentationen werden über Knoten organisiert, die Text enthalten und die Struktur des Diagramms definieren. Aspose.Slides ermöglicht es, programmgesteuert mit diesen SmartArt‑Knoten zu arbeiten: neue Knoten und Unterknoten hinzuzufügen, Unterknoten an einer bestimmten Position einzufügen, vorhandene Knoten zuzugreifen und deren Text, Ebene und Position auszulesen.

Dieser Artikel erklärt, wie SmartArt‑Formknoten verwaltet werden. Er zeigt, wie Knoten entfernt werden, wie mit Unterknoten nach Index oder Position gearbeitet wird, wie ein Assistent‑Knoten in einen normalen Knoten umgewandelt wird, wie Position, Größe und Drehung von SmartArt‑Knoten‑Formen angepasst werden, wie Füllformate für Knoten festgelegt und wie ein Miniaturbild für einen SmartArt‑Unterknoten erzeugt wird.

SmartArt‑Knoten hinzufügen

Aspose.Slides für Python via Java stellt eine API zum Verwalten von SmartArt‑Formen bereit. Das folgende Beispiel fügt einer SmartArt‑Form einen Knoten und einen Unterknoten hinzu.

Erstellen Sie eine Instanz der Presentation‑Klasse und laden Sie die Präsentation, die eine SmartArt‑Form enthält.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Durchlaufen Sie jede Form auf der ersten Folie.
Prüfen Sie, ob die Form eine Instanz von SmartArt ist.
Neuen Knoten hinzufügen zur Knotensammlung der SmartArt‑Form und setzen Sie dessen Text über TextFrame.
Hinzufügen eines Unterknotens zum neuen Knoten und setzen Sie dessen Text über TextFrame.
Speichern Sie die Präsentation.

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‑Knoten an einer bestimmten Position hinzufügen

Das folgende Beispiel fügt einem SmartArt‑Knoten einen Unterknoten an einer bestimmten Position hinzu.

Erstellen Sie eine Instanz der Presentation‑Klasse.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Fügen Sie der Folie eine SmartArt‑Form mit dem Layout StackedList hinzu.
Greifen Sie auf den ersten Knoten der hinzugefügten SmartArt‑Form zu.
Fügen Sie dem ausgewählten Knoten mit addNodeByPosition an Position 2 einen Unterknoten hinzu und setzen Sie dessen Text.
Speichern Sie die Präsentation.

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

Zugriff auf einen SmartArt‑Knoten

Das folgende Beispiel greift auf Knoten in einer SmartArt‑Form zu. Das durch getLayout zurückgegebene Layout ist schreibgeschützt und wird festgelegt, wenn die SmartArt‑Form hinzugefügt wird.

Erstellen Sie eine Instanz der Presentation‑Klasse und laden Sie die Präsentation, die eine SmartArt‑Form enthält.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Durchlaufen Sie jede Form auf der ersten Folie.
Prüfen Sie, ob die Form eine Instanz von SmartArt ist.
Durchlaufen Sie alle Knoten in der SmartArt‑Form.
Lesen und geben Sie die Position, Ebene und den Text jedes SmartArt‑Knotens aus.

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

Zugriff auf einen SmartArt‑Unterknoten

Das folgende Beispiel greift auf die Unterknoten jedes Knotens in einer SmartArt‑Form zu.

Erstellen Sie eine Instanz der Presentation‑Klasse und laden Sie die Präsentation, die eine SmartArt‑Form enthält.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Durchlaufen Sie jede Form auf der ersten Folie.
Prüfen Sie, ob die Form eine Instanz von SmartArt ist.
Durchlaufen Sie alle Knoten in der SmartArt‑Form.
Für jeden Knoten durchlaufen Sie dessen Unterknoten.
Lesen und geben Sie die Position, Ebene und den Text des Unterknotens aus.

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

Zugriff auf einen SmartArt‑Unterknoten an einer bestimmten Position

Das folgende Beispiel greift auf einen Unterknoten an einem bestimmten Index in der Sammlung seines übergeordneten Knotens zu.

Erstellen Sie eine Instanz der Presentation‑Klasse.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Fügen Sie eine SmartArt‑Form mit dem Layout StackedList hinzu.
Greifen Sie auf die hinzugefügte SmartArt‑Form zu.
Greifen Sie auf den Knoten mit Index 0 in der SmartArt‑Form zu.
Greifen Sie mit get_Item auf den Unterknoten mit Index 1 zu.
Lesen und geben Sie die Position, Ebene und den Text des Unterknotens aus.

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‑Knoten entfernen

Das folgende Beispiel entfernt einen Knoten aus einer SmartArt‑Form.

Erstellen Sie eine Instanz der Presentation‑Klasse und laden Sie die Präsentation, die eine SmartArt‑Form enthält.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Durchlaufen Sie jede Form auf der ersten Folie.
Prüfen Sie, ob die Form eine Instanz von SmartArt ist.
Stellen Sie sicher, dass die SmartArt‑Form mindestens einen Knoten enthält.
Wählen Sie den zu löschenden SmartArt‑Knoten aus.
Entfernen Sie den ausgewählten Knoten mit removeNode.
Speichern Sie die Präsentation.

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‑Knoten an einer bestimmten Position entfernen

Das folgende Beispiel entfernt einen Unterknoten an einem bestimmten Index in der Sammlung eines SmartArt‑Knotens.

Erstellen Sie eine Instanz der Presentation‑Klasse und laden Sie die Präsentation, die eine SmartArt‑Form enthält.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Durchlaufen Sie jede Form auf der ersten Folie.
Prüfen Sie, ob die Form eine Instanz von SmartArt ist.
Greifen Sie, falls vorhanden, auf den SmartArt‑Knoten mit Index 0 zu.
Stellen Sie sicher, dass der ausgewählte SmartArt‑Knoten mindestens zwei Unterknoten hat.
Entfernen Sie den Unterknoten mit Index 1 mittels removeNode.
Speichern Sie die Präsentation.

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

Benutzerdefinierte Position für einen Unterknoten in einem SmartArt‑Objekt festlegen

Aspose.Slides für Python via Java unterstützt das Festlegen der Position einer SmartArtShape über setX und setY. Das folgende Beispiel legt eine benutzerdefinierte Position, Größe und Drehung für SmartArt‑Knoten‑Formen fest. Das Hinzufügen neuer Knoten berechnet die Positionen und Größen aller Knoten neu. Durch benutzerdefinierte Positionierung können Knoten nach Bedarf angeordnet werden.

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

Assistent‑Knoten prüfen

Hinweis

Dieser Abschnitt behandelt SmartArt‑Formen, die programmgesteuert zu Präsentationsfolien mithilfe von Aspose.Slides für Python via Java hinzugefügt werden.

Die folgende Quell‑SmartArt‑Form wird in diesem Beispiel verwendet.


Abbildung: Ausgangs‑SmartArt‑Form auf einer Folie

Das folgende Beispiel identifiziert Assistent‑Knoten in einer SmartArt‑Knotensammlung und wandelt sie in normale Knoten um.

Erstellen Sie eine Instanz der Presentation‑Klasse und laden Sie die Präsentation, die eine SmartArt‑Form enthält.
Rufen Sie die erste Folie anhand ihres Indexes ab.
Durchlaufen Sie jede Form auf der ersten Folie.
Prüfen Sie, ob die Form eine Instanz von SmartArt ist.
Durchlaufen Sie alle Knoten in der SmartArt‑Form und prüfen Sie, ob sie Assistant Nodes sind.
Ändern Sie jeden Assistent‑Knoten in einen normalen Knoten.
Speichern Sie die Präsentation.

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


Abbildung: Assistent‑Knoten in einer SmartArt‑Form auf einer Folie geändert

Füllformat eines Knotens festlegen

Aspose.Slides für Python via Java ermöglicht das Hinzufügen benutzerdefinierter SmartArt‑Formen und das Festlegen ihres Füllformats. Dieser Artikel erklärt, wie SmartArt‑Formen erstellt und zugegriffen sowie ihr Füllformat mit Aspose.Slides für Python via Java festgelegt wird.

Bitte folgen Sie den untenstehenden Schritten:

Erstellen Sie eine Instanz der Presentation‑Klasse.
Holen Sie eine Folie anhand ihres Indexes.
Fügen Sie eine SmartArt‑Form mit dem Layout ClosedChevronProcess hinzu.
Legen Sie das FillFormat für die Knoten der SmartArt‑Form fest.
Schreiben Sie die modifizierte Präsentation als PPTX‑Datei.

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

Miniaturansicht eines SmartArt‑Unterknotens erzeugen

Um eine Miniaturansicht eines SmartArt‑Unterknotens zu erzeugen, gehen Sie wie folgt vor:

Erstellen Sie eine Instanz der Presentation‑Klasse.
Fügen Sie eine SmartArt‑Form hinzu.
Holen Sie einen Knoten anhand seines Indexes.
Holen Sie das Miniaturbild.
Speichern Sie das Miniaturbild in einem gewünschten Bildformat.

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

Wird SmartArt‑Animation unterstützt?

Ja. SmartArt wird wie eine reguläre Form behandelt, sodass Sie Standardanimationen (Eingang, Ausgang, Betonung, Bewegungspfad) anwenden und das Timing anpassen können. Bei Bedarf können Sie auch Formen innerhalb von SmartArt‑Knoten animieren.

Wie kann ich ein bestimmtes SmartArt auf einer Folie zuverlässig finden, wenn seine interne ID unbekannt ist?

Weisen Sie dem SmartArt einen eindeutigen alternativen Text zu und suchen Sie danach. Das Setzen eines unterscheidbaren alternativen Textes ermöglicht es, das SmartArt programmgesteuert zu finden, ohne interne Bezeichner zu verwenden.

Wird das Aussehen von SmartArt beim Konvertieren der Präsentation in PDF erhalten bleiben?

Ja. Aspose.Slides rendert SmartArt mit hoher visueller Treue beim PDF‑Export, wobei Layout, Farben und Effekte erhalten bleiben.

Kann ich ein Bild des gesamten SmartArt extrahieren (für Vorschaubilder oder Berichte)?

Ja. Sie können eine SmartArt‑Form in Rasterformate oder in SVG rendern, um skalierbare Vektorausgaben zu erhalten, die sich für Miniaturansichten, Berichte oder Web‑Nutzung eignen.

SmartArt-Grafiken in Präsentationen mit Python verwalten