JavaScript でスライドレイアウトを適用または変更する

概要

スライドレイアウトは、スライド上のプレースホルダーボックスの配置とコンテンツの書式設定を定義します。利用可能なプレースホルダーとその表示位置を制御します。スライドレイアウトを使用すると、シンプルなものから複雑なものまで、プレゼンテーションを迅速かつ一貫してデザインできます。PowerPoint で最も一般的なスライドレイアウトは次のとおりです：

タイトルスライドレイアウト – タイトル用プレースホルダーとサブタイトル用プレースホルダーの 2 つが含まれます。

タイトルとコンテンツレイアウト – 上部に小さめのタイトルプレースホルダー、下部にテキスト、箇条書き、チャート、画像などのメインコンテンツ用プレースホルダーが配置されます。

ブランクレイアウト – プレースホルダーがなく、スライドをゼロからデザインできる自由度が提供されます。

スライドレイアウトはスライドマスターの一部であり、プレゼンテーション全体のレイアウトスタイルを定義する最上位スライドです。スライドマスター経由でレイアウトスライドにアクセスし、タイプ、名前、または固有 ID で取得または変更できます。あるいは、プレゼンテーション内で特定のレイアウトスライドを直接編集することも可能です。

Aspose.Slides for Node.js でスライドレイアウトを操作するには、次のものを使用します：

Presentation クラスの getLayoutSlides および getMasters メソッド
LayoutSlide、MasterLayoutSlideCollection、LayoutPlaceholderManager、LayoutSlideHeaderFooterManager などの型

Info

マスタースライドの操作方法については、Slide Master 記事をご参照ください。

プレゼンテーションへのスライドレイアウトの追加

スライドの外観や構造をカスタマイズするために、新しいレイアウトスライドをプレゼンテーションに追加する必要があります。Aspose.Slides for Node.js では、特定のレイアウトが既に存在するか確認し、必要に応じて新規作成し、そのレイアウトに基づいてスライドを挿入できます。

Presentation クラスのインスタンスを作成します。
MasterLayoutSlideCollection にアクセスします。
目的のレイアウトスライドがコレクションに存在するかチェックし、存在しなければ追加します。
新しいレイアウトスライドを基に空のスライドを追加します。
プレゼンテーションを保存します。

以下の JavaScript コードは、PowerPoint プレゼンテーションにスライドレイアウトを追加する方法を示しています：

// PowerPoint ファイルを表す Presentation クラスのインスタンスを作成します。
let presentation = new aspose.slides.Presentation("Sample.pptx");
try {
    // レイアウト スライドの種類を走査して、レイアウト スライドを選択します。
    let layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    let layoutSlide = null;
    if (layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.TitleAndObject)) != null) {
        layoutSlide = layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.TitleAndObject));
    } else {
        layoutSlide = layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.Title));
    }

    if (layoutSlide == null) {
        // プレゼンテーションにすべてのレイアウト タイプが含まれていない状況です。
        // プレゼンテーション ファイルには Blank と Custom のレイアウト タイプしか含まれていません。
        // ただし、カスタム タイプのレイアウト スライドは認識できる名前を持つ場合があります、
        // 例として "Title", "Title and Content", etc., which can be used for layout slide selection.
        // プレースホルダー シェイプ タイプの集合に頼ることもできます。
        // 例として、Title スライドは Title プレースホルダー タイプだけを持つべきです。
        for (let i = 0; i < layoutSlides.size(); i++) {
            let titleAndObjectLayoutSlide = layoutSlides.get_Item(i);
            if (titleAndObjectLayoutSlide.getName() === "Title and Object") {
                layoutSlide = titleAndObjectLayoutSlide;
                break;
            }
        }

        if (layoutSlide == null) {
            for (let i = 0; i < layoutSlides.size(); i++) {
                let titleLayoutSlide = layoutSlides.get_Item(i);
                if (titleLayoutSlide.getName() === "Title") {
                    layoutSlide = titleLayoutSlide;
                    break;
                }
            }

            if (layoutSlide == null) {
                layoutSlide = layoutSlides.getByType(java.newByte(aspose.slides.SlideLayoutType.Blank));
                if (layoutSlide == null) {
                    layoutSlide = layoutSlides.add(java.newByte(aspose.slides.SlideLayoutType.TitleAndObject), "Title and Object");
                }
            }
        }
    }

    // 追加したレイアウト スライドを使用して空のスライドを追加します。
    presentation.getSlides().insertEmptySlide(0, layoutSlide);

    // プレゼンテーションをディスクに保存します。
    presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

未使用レイアウトスライドの削除

Aspose.Slides は、Compress クラスの removeUnusedLayoutSlides メソッドを提供し、不要または未使用のレイアウトスライドを削除できます。

以下の JavaScript コードは、PowerPoint プレゼンテーションからレイアウトスライドを削除する方法を示しています：

let presentation = new aspose.slides.Presentation("Presentation.pptx");
try {
    aspose.slides.Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("Output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

スライドレイアウトへのプレースホルダーの追加

Aspose.Slides は、LayoutSlide.getPlaceholderManager メソッドを提供し、レイアウトスライドに新しいプレースホルダーを追加できます。

このマネージャーは、以下のプレースホルダータイプに対応するメソッドを提供します：

PowerPoint プレースホルダー	LayoutPlaceholderManager メソッド
	addContentPlaceholder(float x, float y, float width, float height)
	addVerticalContentPlaceholder(float x, float y, float width, float height)
	addTextPlaceholder(float x, float y, float width, float height)
	addVerticalTextPlaceholder(float x, float y, float width, float height)
	addPicturePlaceholder(float x, float y, float width, float height)
	addChartPlaceholder(float x, float y, float width, float height)
	addTablePlaceholder(float x, float y, float width, float height)
	addSmartArtPlaceholder(float x, float y, float width, float height)
	addMediaPlaceholder(float x, float y, float width, float height)
	addOnlineImagePlaceholder(float x, float y, float width, float height)

以下の JavaScript コードは、Blank レイアウトスライドに新しいプレースホルダーシェイプを追加する方法を示しています：

let presentation = new aspose.slides.Presentation();
try {
    // Blank レイアウト スライドを取得します。
    let layout = presentation.getLayoutSlides().getByType(java.newByte(aspose.slides.SlideLayoutType.Blank));

    // レイアウト スライドのプレースホルダー マネージャーを取得します。
    let placeholderManager = layout.getPlaceholderManager();

    // Blank レイアウト スライドにさまざまなプレースホルダーを追加します。
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    // Blank レイアウトで新しいスライドを追加します。
    let newSlide = presentation.getSlides().addEmptySlide(layout);

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

結果：

The placeholders on the layout slide

レイアウトスライドのフッター表示設定

PowerPoint プレゼンテーションでは、フッター要素（日付、スライド番号、カスタムテキスト）をレイアウトに応じて表示・非表示を切り替えることができます。Aspose.Slides for Node.js は、これらフッタープレースホルダーの表示状態を制御でき、特定のレイアウトだけフッター情報を表示し、他はクリーンなままにできます。

Presentation クラスのインスタンスを作成します。
インデックスでレイアウトスライドの参照を取得します。
スライドフッタープレースホルダーを表示に設定します。
スライド番号プレースホルダーを表示に設定します。
日付/時刻プレースホルダーを表示に設定します。
プレゼンテーションを保存します。

以下の JavaScript コードは、スライドフッターの表示設定と関連操作を示しています：

let presentation = new aspose.slides.Presentation("Presentation.ppt");
try {
    let headerFooterManager = presentation.getLayoutSlides().get_Item(0).getHeaderFooterManager();

    if (!headerFooterManager.isFooterVisible()) {
        headerFooterManager.setFooterVisibility(true);
    }

    if (!headerFooterManager.isSlideNumberVisible()) {
        headerFooterManager.setSlideNumberVisibility(true);
    }

    if (!headerFooterManager.isDateTimeVisible()) {
        headerFooterManager.setDateTimeVisibility(true);
    }

    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

    presentation.save("Presentation.ppt", aspose.slides.SaveFormat.Ppt);
} finally {
    presentation.dispose();
}

スライドの子フッター表示設定

PowerPoint プレゼンテーションでは、日付、スライド番号、カスタムテキストなどのフッター要素をマスタースライドレベルで制御し、すべての子レイアウトスライドに一貫した情報を提供できます。Aspose.Slides for Node.js は、マスタースライド上でフッタープレースホルダーの表示状態と内容を設定し、これらの設定をすべての子レイアウトスライドに伝播させることができます。

Presentation クラスのインスタンスを作成します。
インデックスでマスタースライドの参照を取得します。
マスターとすべての子フッタープレースホルダーを表示に設定します。
マスターとすべての子スライド番号プレースホルダーを表示に設定します。
マスターとすべての子日付/時刻プレースホルダーを表示に設定します。
プレゼンテーションを保存します。

以下の JavaScript コードは、この操作を示しています：

let presentation = new aspose.slides.Presentation("Presentation.ppt");
try {
    let headerFooterManager = presentation.getMasters().get_Item(0).getHeaderFooterManager();

    headerFooterManager.setFooterAndChildFootersVisibility(true);
    headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);

    headerFooterManager.setFooterAndChildFootersText("Footer text");
    headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");

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

FAQ

マスタースライドとレイアウトスライドの違いは何ですか？

マスタースライドは全体的なテーマとデフォルト書式を定義し、レイアウトスライドはコンテンツの種類ごとにプレースホルダーの具体的な配置を定義します。

レイアウトスライドを別のプレゼンテーションにコピーできますか？

はい、getLayoutSlides メソッドで取得できるレイアウトスライドコレクションからレイアウトスライドをクローンし、addClone メソッドを使用して別のプレゼンテーションに挿入できます。

使用中のスライドが参照しているレイアウトスライドを削除するとどうなりますか？

プレゼンテーション内で少なくとも 1 つのスライドが参照しているレイアウトスライドを削除しようとすると、Aspose.Slides は PptxEditException をスローします。この問題を回避するには、使用されていないレイアウトスライドだけを安全に削除できる removeUnusedLayoutSlides を使用してください。

プレゼンテーションビューアプレゼンテーションプロパティ

JavaScript でスライドレイアウトを適用または変更する

概要

Info

プレゼンテーションへのスライド レイアウトの追加

未使用レイアウト スライドの削除

スライド レイアウトへのプレースホルダーの追加

レイアウト スライドのフッター表示設定

スライドの子フッター表示設定

FAQ

プレゼンテーションへのスライドレイアウトの追加

未使用レイアウトスライドの削除

スライドレイアウトへのプレースホルダーの追加

レイアウトスライドのフッター表示設定