SmartArt kezelése PowerPoint prezentációkban JavaScript használatával

Áttekintés

A SmartArt egy PowerPoint diagram, amely csomópontokból, csomópont alakzatokból és egy elrendezésből áll. Az Aspose.Slides a Node.js számára Java-on keresztül segítségével létrehozhat SmartArt-ot, olvashat szöveget a csomópontjaiból, megváltoztathatja az elrendezését, ellenőrizheti a rejtett csomópontokat, konfigurálhatja a szervezeti diagram elrendezéseket, és létrehozhat kép szervezeti diagramokat.

Szöveg lekérése egy SmartArt objektumból

Egy SmartArt csomópont egy vagy több alakzatot tartalmazhat. A csomópont alakzatokból való szöveg olvasásához iteráljon a SmartArt.getAllNodes, majd olvassa el a TextFrame által visszaadott SmartArtShape.getTextFrame.
A példához legalább egy diával és egy SmartArt objektummal rendelkező prezentációra van szükség, ahol a SmartArt az első alakzat a dián. Kiírja az összes elérhető szövegkeretet a konzolra.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("sample.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let shape = slide.getShapes().get_Item(0);

    if (java.instanceOf(shape, "com.aspose.slides.ISmartArt")) {
        let smartArt = shape;
        let nodes = smartArt.getAllNodes();

        for (let nodeIndex = 0; nodeIndex < nodes.size(); nodeIndex++) {
            let node = nodes.get_Item(nodeIndex);
            let nodeShapes = node.getShapes();

            for (let shapeIndex = 0; shapeIndex < nodeShapes.size(); shapeIndex++) {
                let nodeShape = nodeShapes.get_Item(shapeIndex);

                if (nodeShape.getTextFrame() != null) {
                    console.log(nodeShape.getTextFrame().getText());
                }
            }
        }
    } else {
        console.log("The first shape is not a SmartArt object.");
    }
} finally {
    presentation.dispose();
}

A SmartArt objektum elrendezéstípusának módosítása

A SmartArt elrendezés szabályozza, hogy a csomópontok hogyan vannak elhelyezve és összekapcsolva. A következő példa egy SmartArt objektumot hoz létre a SmartArtLayoutType BasicBlockList értékkel, átváltja BasicProcess értékre, és elmenti a prezentációt. A ShapeCollection.addSmartArt‑nak átadott pozíciót és méretet pontban mérik. Használja a SmartArt.setLayout‑t az elrendezés módosításához.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, aspose.slides.SmartArtLayoutType.BasicBlockList);
    smartArt.setLayout(aspose.slides.SmartArtLayoutType.BasicProcess);

    presentation.save("ChangeSmartArtLayout.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ellenőrizze, hogy egy SmartArt csomópont rejtett-e

SmartArtNode.isHidden jelzi, hogy a csomópont rejtett-e a SmartArt adatmodellben. A rejtett csomópontok létezhetnek a struktúrában akkor is, ha a kiválasztott elrendezés nem jeleníti meg őket látható diagram elemekként.
A következő példa egy csomópontot ad egy SmartArt objektumhoz, amely a SmartArtLayoutType RadialCycle értéket használ, és ellenőrzi a hozzáadott csomópont rejtett állapotát. Üzenetet ír ki, ha a csomópont rejtett, és elmenti a diagramot.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, aspose.slides.SmartArtLayoutType.RadialCycle);
    let node = smartArt.getAllNodes().addNode();
    let isHidden = node.isHidden();

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

    presentation.save("CheckSmartArtHiddenProperty.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

A szervezeti diagram elrendezésének lekérdezése vagy beállítása

A szervezeti diagram elrendezést használó SmartArt diagramok esetén a SmartArtNode.getOrganizationChartLayout és a SmartArtNode.setOrganizationChartLayout határozza meg, hogy a gyermekcsomópontok hogyan helyezkednek el egy szülőcsomópont alatt. Például beállíthatja, hogy a gyermekcsomópontok balról, jobbról vagy mindkét oldalról függjenek, a kiválasztott OrganizationChartLayoutType függvényében.
A következő példa létrehoz egy szervezeti diagramot, és az első csomópont elrendezését a OrganizationChartLayoutType LeftHanging értékre állítja. A 0‑al kezdődő index 0 az első felső szintű csomópontot választja ki; annak gyermekcsomópontjai a kiválasztott elrendezést használják. A módosított prezentációt ezután elmenti.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, aspose.slides.SmartArtLayoutType.OrganizationChart);
    let rootNode = smartArt.getNodes().get_Item(0);
    rootNode.setOrganizationChartLayout(aspose.slides.OrganizationChartLayoutType.LeftHanging);

    presentation.save("OrganizationChartLayout.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Kép szervezeti diagram létrehozása

A kép szervezeti diagram egy olyan SmartArt elrendezés, amely hierarchikus diagramokhoz készült, és képhelyeket tartalmaz. Használja a SmartArtLayoutType PictureOrganizationChart értéket a SmartArt objektum diára való hozzáadásakor. Ez a példa egy diagramot ment el képhelyekkel; a helyőrzőket nem tölti fel képekkel.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let smartArt = slide.getShapes().addSmartArt(0, 0, 400, 400, aspose.slides.SmartArtLayoutType.PictureOrganizationChart);

    presentation.save("PictureOrganizationChart.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Örökölt diagramok átalakítása alakzatcsoportokká

Egy meglévő prezentáció modernizálásakor szükség lehet egy eredetileg PowerPoint 97–2003-ban létrehozott szervezeti diagram frissítésére. Az Aspose.Slides ezeket az örökölt diagramokat LegacyDiagram objektumokként jeleníti meg. Használja a LegacyDiagram.convertToGroupShape‑t a diagram alakzatcsoportba konvertálásához, hogy egyes vizuális elemeket szerkeszthessen. A részletekért tekintse meg a LegacyDiagram API Reference.
A konverzió egy új csoportot ad az alakzateloszláshoz anélkül, hogy eltávolítaná az eredeti diagramot. Sikeres konverzió után távolítsa el az eredetit a ShapeCollection.remove segítségével, hogy elkerülje a duplikált tartalmat. Gyűjtse össze az örökölt diagramokat egy listába a konvertálás előtt, hogy az alakzatok hozzáadása és eltávolítása ne szakítsa meg az iterációt.
A következő példa megnyit egy prezentációt, minden diát keres, a diagramokat alakzatcsoportokká konvertálja, és elmenti a frissített prezentációt PPTX formátumban.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("legacy-diagrams.ppt");
try {
    let slides = presentation.getSlides();
    for (let slideIndex = 0; slideIndex < slides.size(); slideIndex++) {
        let slide = slides.get_Item(slideIndex);
        let shapes = slide.getShapes();
        let legacyDiagrams = [];
        for (let shapeIndex = 0; shapeIndex < shapes.size(); shapeIndex++) {
            let shape = shapes.get_Item(shapeIndex);
            if (java.instanceOf(shape, "com.aspose.slides.ILegacyDiagram")) {
                legacyDiagrams.push(shape);
            }
        }

        for (let legacyDiagram of legacyDiagrams) {
            let groupShape = legacyDiagram.convertToGroupShape();

            if (groupShape != null) {
                shapes.remove(legacyDiagram);
            }
        }
    }

    presentation.save("modernized.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Az elmentett prezentáció szerkeszthető alakzatcsoportokat tartalmaz az átalakított örökölt diagramok helyén, az eredeti diagramok már nem maradnak mellettük. Nyissa meg a PPTX-et a PowerPointban, hogy szerkessze az egyes csoportok elemeit, például a szöveget, a kitöltést vagy a pozíciót.

GYIK

Támogatja a SmartArt a tükrözést vagy a visszafordítást RTL nyelvek esetén?
Igen. A SmartArt.setReversed metódus megfordítja a diagram irányát balról jobbra és jobbról balra, vagy vissza, ha a kiválasztott SmartArt elrendezés támogatja a visszafordítást.

Hogyan másolhatom a SmartArt-ot ugyanarra a diára vagy egy másik prezentációba, miközben megőrzöm a formázást?
A SmartArt alakzat klónozásával a ShapeCollection.addClone vagy a SmartArt-ot tartalmazó egész dia klónozásával másolhatja. Mindkét módszer megőrzi a méretet, a pozíciót és a formázást.

Hogyan renderelhetem a SmartArt-ot raszteres képre előnézethez vagy webes exporthoz?
A dia renderelésével vagy a teljes prezentáció PNG vagy JPEG formátumba. A SmartArt a dia részeként kerül renderelésre.

Hogyan találhatok meg egy konkrét SmartArt objektumot egy diáron, ha több is van?
Használja a Shape.setAlternativeText vagy a Shape.setName módszert, hogy egy egyedi alternatív szöveget vagy nevet adjon a SmartArt alakzatnak, keresse meg ezt az értéket a BaseSlide.getShapes‑ben, majd ellenőrizze, hogy a megtalált alakzat egy SmartArt‑e.

SmartArt grafikák kezelése prezentációkban JavaScript használatával