Spravovat SmartArt v prezentacích PowerPoint v .NET
Přehled
SmartArt je diagram PowerPointu složený z uzlů, tvarů uzlů a rozvržení. S Aspose.Slides pro .NET můžete vytvářet SmartArt, číst text z jeho uzlů, měnit jeho rozvržení, zkoumat skryté uzly, konfigurovat rozvržení organizačních diagramů a vytvářet diagramy organizačních schémat s obrázky.
Získání textu z objektu SmartArt
Uzel SmartArt může obsahovat jeden nebo více tvarů. Pro čtení textu z tvarů uzlu iterujte přes ISmartArt.AllNodes, poté přečtěte ITextFrame, který vrací ISmartArtShape.TextFrame.
Příklad vyžaduje prezentaci s alespoň jedním snímkem a objektem SmartArt jako prvním tvarem na tomto snímku. Vytiskne každý dostupný textový rámec do konzole.
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);
}
}
}
Změna typu rozvržení objektu SmartArt
Rozvržení SmartArt řídí, jak jsou uzly uspořádány a propojeny. Následující příklad vytvoří objekt SmartArt s hodnotou SmartArtLayoutType BasicBlockList, změní ji na hodnotu BasicProcess a uloží prezentaci. Pozice a velikost předávané metodě IShapeCollection.AddSmartArt jsou měřeny v bodech. Nastavte ISmartArt.Layout, abyste změnili rozvržení.
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);
Zkontrolovat, zda je uzel SmartArt skrytý
ISmartArtNode.IsHidden udává, zda je uzel skrytý v datovém modelu SmartArt. Skryté uzly mohou existovat ve struktuře, i když vybrané rozvržení nezobrazuje je jako viditelné prvky diagramu.
Následující příklad přidá uzel k objektu SmartArt, který používá hodnotu SmartArtLayoutType RadialCycle, a zkontroluje skrytý stav přidaného uzlu. Vytiskne zprávu, pokud je uzel skrytý, a uloží diagram.
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);
Získání nebo nastavení rozvržení organizačního diagramu
U diagramů SmartArt, které používají rozvržení organizačního diagramu, ISmartArtNode.OrganizationChartLayout určuje, jak jsou podřízené uzly uspořádány pod nadřazeným uzlem. Například můžete nastavit podřízené uzly, aby visely zleva, zprava nebo z obou stran, v závislosti na vybraném OrganizationChartLayoutType.
Následující příklad vytvoří organizační diagram a nastaví rozvržení prvního uzlu na hodnotu OrganizationChartLayoutType LeftHanging. Nulový index 0 vybere první uzel nejvyšší úrovně; jeho podřízené uzly použijí vybrané uspořádání. Upravená prezentace je následně uložena.
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);
Vytvoření obrázkového organizačního diagramu
Obrázkový organizační diagram je rozvržení SmartArt určené pro hierarchické diagramy, které obsahují zástupné obrázky. Použijte hodnotu SmartArtLayoutType PictureOrganizationChart při přidávání objektu SmartArt na snímek. Tento příklad uloží diagram se zástupnými obrázky; nezaplní zástupné obrázky skutečnými obrázky.
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);
Převod starých diagramů na skupiny tvarů
Při modernizaci existující prezentace můžete potřebovat aktualizovat organizační diagram původně vytvořený v PowerPointu 97–2003. Aspose.Slides představuje tyto staré diagramy jako objekty ILegacyDiagram. Použijte LegacyDiagram.ConvertToGroupShape, abyste diagram převedli na skupinu tvarů, což vám umožní editovat jednotlivé vizuální prvky. Další podrobnosti najdete v LegacyDiagram API Reference.
Převod přidá novou skupinu do kolekce tvarů, aniž by odstranil původní diagram. Po úspěšném převodu odstraňte originál pomocí IShapeCollection.Remove, aby nedošlo k duplicitnímu obsahu. Shromážděte staré diagramy do pole před jejich převodem, aby přidávání a odstraňování tvarů nerušilo iteraci.
Následující příklad otevře prezentaci, prohledá každý snímek, převede diagramy na skupiny tvarů a uloží aktualizovanou prezentaci jako 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);
Uložená prezentace obsahuje editovatelné skupiny tvarů místo převedených starých diagramů, přičemž žádné původní diagramy již nezůstávají. Otevřete PPTX v PowerPointu a upravte jednotlivé prvky v každé skupině, jako je jejich text, výplň nebo pozice.
Často kladené otázky
Podporuje SmartArt zrcadlení nebo převracení pro RTL jazyky?
Ano. Vlastnost IsReversed přepíná směr diagramu zleva doprava na zprava doleva nebo zpět, pokud vybrané rozvržení SmartArt podporuje převrácení.
Jak mohu kopírovat SmartArt na stejný snímek nebo do jiné prezentace při zachování formátování?
Můžete klonovat tvar SmartArt pomocí ShapeCollection.AddClone nebo klonovat celý snímek, který SmartArt obsahuje. Oba přístupy zachovají velikost, pozici i formátování.
Jak mohu vykreslit SmartArt do rastrového obrázku pro náhled nebo webový export?
Vykreslete snímek nebo celou prezentaci do formátu PNG nebo JPEG. SmartArt je vykreslen jako součást snímku.
Jak mohu najít konkrétní objekt SmartArt na snímku, pokud jich je několik?
Nastavte jedinečnou hodnotu AlternativeText nebo Name na tvaru SmartArt, vyhledejte tuto hodnotu v Slide.Shapes, a poté ověřte, že odpovídající tvar je ISmartArt.