SmartArt in PowerPoint-Präsentationen in .NET verwalten

Übersicht

SmartArt ist ein PowerPoint‑Diagramm, das aus Knoten, Knotformen und einem Layout besteht. Mit Aspose.Slides für .NET können Sie SmartArt erstellen, Text aus dessen Knoten lesen, das Layout ändern, verborgene Knoten überprüfen, Organisationsdiagrammlayouts konfigurieren und Bild‑Organisationsdiagramme erstellen.

Text aus einem SmartArt‑Objekt abrufen

Ein SmartArt‑Knoten kann ein oder mehrere Formen enthalten. Um Text aus den Knotformen zu lesen, iterieren Sie über ISmartArt.AllNodes, dann lesen Sie das ITextFrame , das von ISmartArtShape.TextFrame zurückgegeben wird.

Das Beispiel benötigt eine Präsentation mit mindestens einer Folie und einem SmartArt‑Objekt als erste Form auf dieser Folie. Es gibt jeden verfügbaren Textrahmen in der Konsole aus.

using System;
using Aspose.Slides;
using Aspose.Slides.SmartArt;

using var presentation = new Presentation("sample.pptx");
var slide = presentation.Slides[0];

var smartArt = (ISmartArt) slide.Shapes[0];
foreach (var node in smartArt.AllNodes)
{
    foreach (var nodeShape in node.Shapes)
    {
        if (nodeShape.TextFrame != null)
        {
            Console.WriteLine(nodeShape.TextFrame.Text);
        }
    }
}

Layouttyp eines SmartArt‑Objekts ändern

Das SmartArt‑Layout bestimmt, wie Knoten angeordnet und verbunden werden. Das folgende Beispiel erstellt ein SmartArt‑Objekt mit dem SmartArtLayoutType‑Wert BasicBlockList, ändert ihn zu BasicProcess und speichert die Präsentation. Die an IShapeCollection.AddSmartArt übergebenen Position und Größe werden in Punkt gemessen. Setzen Sie ISmartArt.Layout, um das Layout zu ändern.

using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.SmartArt;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var smartArt = slide.Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
smartArt.Layout = SmartArtLayoutType.BasicProcess;

presentation.Save("ChangeSmartArtLayout.pptx", SaveFormat.Pptx);

Prüfen, ob ein SmartArt‑Knoten verborgen ist

ISmartArtNode.IsHidden gibt an, ob der Knoten im SmartArt‑Datenmodell verborgen ist. Verborgene Knoten können in der Struktur existieren, selbst wenn das ausgewählte Layout sie nicht als sichtbare Diagrammelemente darstellt.

Das folgende Beispiel fügt einem SmartArt‑Objekt, das den SmartArtLayoutType‑Wert RadialCycle verwendet, einen Knoten hinzu und überprüft den verborgenen Zustand des hinzugefügten Knotens. Es gibt eine Meldung aus, wenn der Knoten verborgen ist, und speichert das Diagramm.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.SmartArt;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var smartArt = slide.Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);
var node = smartArt.AllNodes.AddNode();
var isHidden = node.IsHidden;

if (isHidden)
{
    Console.WriteLine("The node is hidden in the SmartArt data model.");
}

presentation.Save("CheckSmartArtHiddenProperty.pptx", SaveFormat.Pptx);

Organisationsdiagramm‑Layout abrufen oder festlegen

Für SmartArt‑Diagramme, die ein Organisationsdiagramm‑Layout verwenden, definiert ISmartArtNode.OrganizationChartLayout , wie untergeordnete Knoten unter einem übergeordneten Knoten angeordnet werden. Sie können z. B. festlegen, dass untergeordnete Knoten links, rechts oder an beiden Seiten hängen, abhängig vom ausgewählten OrganizationChartLayoutType.

Das folgende Beispiel erstellt ein Organisationsdiagramm und setzt das Layout für den ersten Knoten auf den OrganizationChartLayoutType‑Wert LeftHanging. Der nullbasierte Index 0 wählt den ersten Knoten der obersten Ebene aus; seine untergeordneten Knoten verwenden die gewählte Anordnung. Die geänderte Präsentation wird anschließend gespeichert.

using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.SmartArt;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var smartArt = slide.Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);
var rootNode = smartArt.Nodes[0];
rootNode.OrganizationChartLayout = OrganizationChartLayoutType.LeftHanging;

presentation.Save("OrganizationChartLayout.pptx", SaveFormat.Pptx);

Bild‑Organisationsdiagramm erstellen

Ein Bild‑Organisationsdiagramm ist ein SmartArt‑Layout, das für Hierarchie‑Diagramme mit Bild‑Platzhaltern entwickelt wurde. Verwenden Sie den SmartArtLayoutType‑Wert PictureOrganizationChart, wenn Sie das SmartArt‑Objekt zu einer Folie hinzufügen. Dieses Beispiel speichert ein Diagramm mit Bild‑Platzhaltern; es füllt die Platzhalter nicht mit Bildern.

using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.SmartArt;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var smartArt = slide.Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);

presentation.Save("PictureOrganizationChart.pptx", SaveFormat.Pptx);

Legacy‑Diagramme in Gruppen von Formen konvertieren

Beim Modernisieren einer bestehenden Präsentation müssen Sie möglicherweise ein Organisationsdiagramm aktualisieren, das ursprünglich in PowerPoint 97–2003 erstellt wurde. Aspose.Slides stellt diese Legacy‑Diagramme als ILegacyDiagram‑Objekte dar. Verwenden Sie LegacyDiagram.ConvertToGroupShape, um ein Diagramm in eine Gruppe von Formen zu konvertieren, damit Sie einzelne Bildelemente bearbeiten können. Weitere Details finden Sie in der LegacyDiagram API Reference.

Die Konvertierung fügt der Formensammlung eine neue Gruppe hinzu, ohne das ursprüngliche Diagramm zu entfernen. Nach erfolgreicher Konvertierung entfernen Sie das Original mit IShapeCollection.Remove, um doppelte Inhalte zu vermeiden. Sammeln Sie die Legacy‑Diagramme vor der Konvertierung in ein Array, damit das Hinzufügen und Entfernen von Formen die Iteration nicht stört.

Das folgende Beispiel öffnet eine Präsentation, durchsucht jede Folie, konvertiert die Diagramme in Gruppen von Formen und speichert die aktualisierte Präsentation als PPTX.

using System.Linq;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("legacy-diagrams.ppt");

foreach (var slide in presentation.Slides)
{
    var legacyDiagrams = slide.Shapes.OfType<ILegacyDiagram>().ToArray();
    foreach (var legacyDiagram in legacyDiagrams)
    {
        var groupShape = legacyDiagram.ConvertToGroupShape();

        if (groupShape != null)
        {
            slide.Shapes.Remove(legacyDiagram);
        }
    }
}

presentation.Save("modernized.pptx", SaveFormat.Pptx);

Die gespeicherte Präsentation enthält bearbeitbare Gruppen von Formen anstelle der konvertierten Legacy‑Diagramme, wobei keine Originaldiagramme mehr daneben vorhanden sind. Öffnen Sie die PPTX in PowerPoint, um einzelne Elemente innerhalb jeder Gruppe zu bearbeiten, z. B. deren Text, Füllung oder Position.

FAQ

Unterstützt SmartArt Spiegeln oder Umkehren für RTL‑Sprachen?

Ja. Die IsReversed‑Eigenschaft wechselt die Diagrammrichtung von links‑nach‑rechts zu rechts‑nach‑links oder zurück, wenn das ausgewählte SmartArt‑Layout die Umkehrung unterstützt.

Wie kann ich SmartArt auf derselben Folie oder in eine andere Präsentation kopieren und dabei die Formatierung beibehalten?

Sie können die SmartArt‑Form klonen mit ShapeCollection.AddClone oder die gesamte Folie, die die SmartArt enthält, klonen. Beide Ansätze bewahren Größe, Position und Formatierung.

Wie render ich SmartArt zu einem Rasterbild für die Vorschau oder den Web‑Export?

Rendern Sie die Folie oder die gesamte Präsentation zu PNG oder JPEG. SmartArt wird als Teil der Folie gerendert.

Wie finde ich ein bestimmtes SmartArt‑Objekt auf einer Folie, wenn mehrere vorhanden sind?

Setzen Sie einen eindeutigen AlternativeText‑ oder Name‑Wert auf die SmartArt‑Form, suchen Sie nach diesem Wert in Slide.Shapes, und prüfen Sie anschließend, ob die gefundene Form ein ISmartArt ist.