JavaScript でプレゼンテーションの描画ガイドを管理する

このページの概要

Aspose.Slides for Node.js via Java を使用して、PowerPoint プレゼンテーションに水平および垂直の描画ガイドを追加、取得、クリアします。

Overview

描画ガイドは、PowerPoint でプレゼンテーションを編集する際に、形状を一貫して整列させるのに役立つ、調整可能な水平および垂直のラインです。アプリケーションがプレゼンテーションを生成し、後で手動で調整する場合に特に有用で、アプリケーションは、コンテンツを追加または移動する際に作者が従うべき同じ整列支援情報を保存できます。

描画ガイドはスライドコンテンツではなく、編集時の補助ツールです。スライドショーやレンダリングされた出力には表示されません。Aspose.Slides for Node.js via Java は、DrawingGuidesCollection クラスを通じてこれらを公開します。ガイドは DrawingGuide で表され、方向、位置、色を持ちます。

位置は、対象のスライドまたはマスタの左上隅からポイント単位で測定されます。垂直ガイドは水平座標を使用し、通常は 0 からスライド幅までの範囲です。水平ガイドは垂直座標を使用し、通常は 0 からスライドの高さまでの範囲です。

Add Guides to the Slide View

CommonSlideViewProperties.getDrawingGuides を使用して、通常のスライドを編集中に表示されるガイドを管理します。DrawingGuidesCollection.add を呼び出し、Orientation の値とポイント単位の位置を指定します。

次の例は、スライドの中心の右側に垂直ガイドを 1 本、下側に水平ガイドを 1 本追加します:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const slideSize = presentation.getSlideSize().getSize();
    const guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    guides.add(slides.Orientation.Vertical, slideSize.getWidth() / 2 + 12.5);
    guides.add(slides.Orientation.Horizontal, slideSize.getHeight() / 2 + 12.5);

    presentation.save("drawing-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Access Drawing Guides

DrawingGuidesCollection.getCount および DrawingGuidesCollection.get_Item メソッドで既存のガイドにアクセスできます。DrawingGuide.getOrientation、DrawingGuide.getPosition、DrawingGuide.getColor メソッドは値を返し、対応する setter メソッドを使用して変更することもできます。

次の例は、上記で作成したプレゼンテーションからスライドビューのガイドを読み取ります:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("drawing-guides.pptx");
try {
    const guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    for (let index = 0; index < guides.getCount(); index++) {
        const guide = guides.get_Item(index);
        console.log("Guide " + index + ": orientation = " + guide.getOrientation() + ", position = " + guide.getPosition() + ", color = " + guide.getColor());
    }
} finally {
    presentation.dispose();
}

Add Guides to Master and Layout Slides

スライドマスタおよびそのレイアウトスライドそれぞれが独自の描画ガイドコレクションを持つことができます。マスタスライドには MasterSlide.getDrawingGuides を、レイアウトスライドには LayoutSlide.getDrawingGuides を使用します。

次の例は、最初のマスタスライドに垂直ガイドを、最初のレイアウトスライドに水平ガイドを追加します:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const slideSize = presentation.getSlideSize().getSize();
    const masterGuides = presentation.getMasters().get_Item(0).getDrawingGuides();
    const layoutGuides = presentation.getLayoutSlides().get_Item(0).getDrawingGuides();

    masterGuides.add(slides.Orientation.Vertical, slideSize.getWidth() / 2 - 20);
    layoutGuides.add(slides.Orientation.Horizontal, slideSize.getHeight() / 2 + 20);

    presentation.save("master-layout-drawing-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Add Guides to Notes and Handout Masters

ノートマスタとハンドアウトマスタも描画ガイドをサポートします。MasterNotesSlide.getDrawingGuides と MasterHandoutSlide.getDrawingGuides を使用してそれらのコレクションにアクセスします。プレゼンテーションにこれらのマスタが含まれていない場合、MasterNotesSlideManager.setDefaultMasterNotesSlide または MasterHandoutSlideManager.setDefaultMasterHandoutSlide がデフォルトマスタを作成し、返します。

次の例は、ノートマスタに水平ガイドを、ハンドアウトマスタに垂直ガイドを追加します:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const notesSize = presentation.getNotesSize().getSize();
    const notesMaster = presentation.getMasterNotesSlideManager().setDefaultMasterNotesSlide();
    const handoutMaster = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();

    notesMaster.getDrawingGuides().add(slides.Orientation.Horizontal, notesSize.getHeight() / 2 + 50);
    handoutMaster.getDrawingGuides().add(slides.Orientation.Vertical, notesSize.getWidth() / 2 - 50);

    presentation.save("notes-handout-drawing-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Clear Drawing Guides

特定のコレクションからすべてのガイドを削除するには、DrawingGuidesCollection.clear を呼び出します。1 つのコレクションをクリアしても、別のスコープに保存されているガイドには影響しません。

次の例は、欠落したマスタを作成せずに、スライドビューのガイドとスライドマスタ、レイアウトスライド、ノートマスタ、ハンドアウトマスタ上のすべてのガイドをクリアします:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation-with-guides.pptx");
try {
    presentation.getViewProperties().getSlideViewProperties().getDrawingGuides().clear();

    for (let index = 0; index < presentation.getMasters().size(); index++) {
        presentation.getMasters().get_Item(index).getDrawingGuides().clear();
    }

    for (let index = 0; index < presentation.getLayoutSlides().size(); index++) {
        presentation.getLayoutSlides().get_Item(index).getDrawingGuides().clear();
    }

    const notesMaster = presentation.getMasterNotesSlideManager().getMasterNotesSlide();
    if (notesMaster !== null) {
        notesMaster.getDrawingGuides().clear();
    }

    const handoutMaster = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();
    if (handoutMaster !== null) {
        handoutMaster.getDrawingGuides().clear();
    }

    presentation.save("presentation-without-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

描画ガイドはスライドショーやエクスポートされた画像に表示されますか？

いいえ。描画ガイドは編集時の整列補助ツールであり、プレゼンテーションコンテンツとしてレンダリングされません。

個々の通常スライドに直接描画ガイドを追加できますか？

通常スライドの編集ガイドは、プレゼンテーションのスライドビュープロパティに保存されます。スライドマスタ、レイアウトスライド、ノートマスタ、ハンドアウトマスタ用の別個のガイドコレクションが用意されています。

ガイドの位置単位は何ですか？

位置はポイント単位で指定され、72 ポイントが 1 インチに相当します。垂直位置は左端から、水平位置は上端から測定されます。

描画ガイドをクリアすると、図形が削除されたりスライドコンテンツが変更されたりしますか？

いいえ。DrawingGuidesCollection.clear メソッドは、選択されたコレクション内のガイドのみを削除します。図形やその他のスライドコンテンツは変更されません。

プレゼンテーションビュープロパティ Node.js でプレゼンテーションのコメントを管理する