PowerPoint プレゼンテーションで JavaScript を使用して SmartArt を管理

このページの概要

Aspose.Slides for Node.js を使用した PowerPoint SmartArt の構築と編集を学び、スライドデザインと自動化を高速化する明確な JavaScript コードサンプルをご紹介します。

概要

SmartArt は、ノード、ノードシェイプ、およびレイアウトで構成される PowerPoint の図です。Aspose.Slides for Node.js via Java を使用すると、SmartArt を作成し、ノードからテキストを取得し、レイアウトを変更し、非表示ノードを検査し、組織図レイアウトを構成し、画像組織図を作成できます。

SmartArt オブジェクトからテキストを取得

SmartArt ノードは 1 つ以上のシェイプを含むことができます。ノードシェイプからテキストを読み取るには、SmartArt.getAllNodes を列挙し、SmartArtShape.getTextFrame が返す TextFrame を読み取ります。

この例は、少なくとも 1 枚のスライドと、そのスライドの最初のシェイプとして SmartArt オブジェクトが配置されたプレゼンテーションが必要です。利用可能な各テキストフレームをコンソールに出力します。

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

SmartArt オブジェクトのレイアウトタイプを変更

SmartArt のレイアウトは、ノードの配置と接続方法を制御します。次の例は、SmartArtLayoutType の BasicBlockList 値で SmartArt オブジェクトを作成し、BasicProcess 値に変更してプレゼンテーションを保存します。ShapeCollection.addSmartArt に渡す位置とサイズはポイント単位です。SmartArt.setLayout を使用してレイアウトを変更します。

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

SmartArt ノードが非表示かどうかを確認

SmartArtNode.isHidden は、ノードが SmartArt データモデルで非表示かどうかを示します。非表示ノードは、選択したレイアウトがそれらを可視の図要素として表示しなくても、構造内に存在する可能性があります。

次の例は、SmartArtLayoutType RadialCycle 値を使用する SmartArt オブジェクトにノードを追加し、追加されたノードの非表示状態を確認します。ノードが非表示の場合はメッセージを出力し、図を保存します。

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

組織図レイアウトの取得または設定

組織図レイアウトを使用する SmartArt 図の場合、SmartArtNode.getOrganizationChartLayout と SmartArtNode.setOrganizationChartLayout によって、子ノードが親ノードの下にどのように配置されるかが決まります。たとえば、選択した OrganizationChartLayoutType に応じて、子ノードを左側、右側、または両側にぶら下げるよう設定できます。

次の例は組織図を作成し、最初のノードのレイアウトを OrganizationChartLayoutType LeftHanging 値に設定します。0 から始まるインデックス 0 が最上位ノードを選択し、その子ノードは選択された配置を使用します。変更後のプレゼンテーションを保存します。

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

画像組織図の作成

画像組織図は、画像プレースホルダーを含む階層図向けに設計された SmartArt レイアウトです。スライドに SmartArt オブジェクトを追加する際に、SmartArtLayoutType PictureOrganizationChart 値を使用します。この例は画像プレースホルダー付きの図を保存しますが、プレースホルダーに画像を配置することはありません。

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

レガシーダイアグラムをシェイプグループに変換

既存のプレゼンテーションを最新化する際、PowerPoint 97–2003 で作成された組織図を更新する必要がある場合があります。Aspose.Slides はこれらのレガシーダイアグラムを LegacyDiagram オブジェクトとして表現します。LegacyDiagram.convertToGroupShape を使用して、ダイアグラムをシェイプグループに変換し、個々のビジュアル要素を編集できるようにします。詳細は LegacyDiagram API Reference を参照してください。

変換はシェイプコレクションに新しいグループを追加し、元のダイアグラムは削除しません。変換が成功したら、ShapeCollection.remove で元のダイアグラムを削除し、重複コンテンツを防ぎます。シェイプの追加と削除がイテレーションを妨げないよう、変換前にレガシーダイアグラムをリストに収集してください。

次の例はプレゼンテーションを開き、すべてのスライドを検索し、ダイアグラムをシェイプグループに変換し、更新されたプレゼンテーションを PPTX として保存します。

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

保存されたプレゼンテーションには、変換されたレガシーダイアグラムの代わりに編集可能なシェイプグループが配置されており、元のダイアグラムは残っていません。PPTX を PowerPoint で開くと、各グループ内のテキスト、塗りつぶし、位置などの個別要素を編集できます。

FAQ

SmartArt は RTL 言語向けにミラーリングまたは反転をサポートしていますか？

はい。選択した SmartArt レイアウトが反転に対応している場合、SmartArt.setReversed メソッドにより、図の方向を左から右へ、または右から左へ切り替えることができます。

書式を保持したまま、同じスライドまたは別のプレゼンテーションに SmartArt をコピーするにはどうすればよいですか？

SmartArt シェイプをクローンするには ShapeCollection.addClone を使用するか、SmartArt を含むスライド全体をクローンしてください。どちらの方法でもサイズ、位置、書式が保持されます。

プレビューや Web エクスポートのために SmartArt をラスター画像にレンダリングするにはどうすればよいですか？

スライド全体またはプレゼンテーション全体を PNG または JPEG に変換してください。SmartArt はスライドの一部としてレンダリングされます。

スライドに複数の SmartArt オブジェクトがある場合、特定のオブジェクトをどうやって見つけますか？

Shape.setAlternativeText または Shape.setName を使用して SmartArt シェイプに固有の代替テキストまたは名前を割り当て、BaseSlide.getShapes でその値を検索し、該当シェイプが SmartArt であることを確認してください。

プレゼンテーションビューア