Java でのプレゼンテーションにおける描画ガイドの管理

このページの概要

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

概要

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

描画ガイドは編集用の補助であり、スライドコンテンツではありません。スライドショーやレンダリングされた出力には表示されません。Aspose.Slides for Java はこれらをIDrawingGuidesCollectionインターフェイスで公開します。ガイドはIDrawingGuideで表され、向き、位置、色を持ちます。

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

スライドビューへのガイドの追加

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

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

import com.aspose.slides.*;
import java.awt.geom.Dimension2D;

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

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

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

描画ガイドへのアクセス

IDrawingGuidesCollection.getCount とIDrawingGuidesCollection.get_Item メソッドで既存のガイドにアクセスできます。IDrawingGuide.getOrientation、IDrawingGuide.getPosition、およびIDrawingGuide.getColor メソッドは値を返し、対応するセッターで変更できます。

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

import com.aspose.slides.*;

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

    for (int index = 0; index < guides.getCount(); index++) {
        IDrawingGuide guide = guides.get_Item(index);
        System.out.println("Guide " + index + ": orientation = " + guide.getOrientation() + ", position = " + guide.getPosition() + ", color = " + guide.getColor());
    }
} finally {
    presentation.dispose();
}

マスタースライドとレイアウトスライドへのガイドの追加

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

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

import com.aspose.slides.*;
import java.awt.geom.Dimension2D;

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

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

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

ノートマスターとハンドアウトマスターへのガイドの追加

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

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

import com.aspose.slides.*;
import java.awt.geom.Dimension2D;

Presentation presentation = new Presentation();
try {
    Dimension2D notesSize = presentation.getNotesSize().getSize();
    IMasterNotesSlide notesMaster = presentation.getMasterNotesSlideManager().setDefaultMasterNotesSlide();
    IMasterHandoutSlide handoutMaster = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();

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

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

描画ガイドのクリア

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

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

import com.aspose.slides.*;

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

    for (IMasterSlide masterSlide : presentation.getMasters()) {
        masterSlide.getDrawingGuides().clear();
    }

    for (ILayoutSlide layoutSlide : presentation.getLayoutSlides()) {
        layoutSlide.getDrawingGuides().clear();
    }

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

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

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

FAQ

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

いいえ。描画ガイドは編集用の配置補助であり、プレゼンテーションのコンテンツとして描画されません。

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

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

ガイド位置にはどの単位が使用されますか？

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

描画ガイドをクリアしてもシェイプが削除されたりスライドコンテンツが変更されたりしますか？

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

Java を使用したプレゼンテーションのスライド遷移管理 Java を使用したプレゼンテーションのスライドセクションの管理