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

このページの概要

Aspose.Slides for Node.js を使用して、スライドレイアウトを適用、作成、変更し、プレースホルダーを追加し、未使用レイアウトを削除し、フッターの表示を制御します。

概要

スライドレイアウトは、タイトル、テキスト、画像、チャート、テーブルなどのプレースホルダーの位置と書式を定義します。レイアウトを適用すると、スライドが一貫した構造を持つようになり、各スライドは独自のコンテンツを保持できます。

最も一般的なレイアウトは次のとおりです。

Title Slide: タイトルプレースホルダーとサブタイトルプレースホルダーを含みます。
Title and Content: タイトルプレースホルダーと汎用コンテンツプレースホルダーを含みます。
Blank: コンテンツプレースホルダーがなく、すべての図形を手動で配置する場合に便利です。

レイアウト継承の理解

プレゼンテーションには次の 3 つの関連レベルがあります。

マスタースライドはテーマ、共有書式、背景、共通オブジェクトを定義します。
レイアウトスライドはマスターに属し、特定のプレースホルダー配置を定義します。
通常スライドは 1 つのレイアウトを使用し、そのスライド用に入力されたコンテンツを保持します。

通常スライドはレイアウトからテーマと書式を継承し、レイアウトはマスターから継承します。通常スライド上で直接設定された値は、そのレベルで継承された値を上書きします。通常スライドが作成されると、選択されたレイアウトからプレースホルダー図形が生成され、プレースホルダーに入力されたコンテンツは通常スライドに属します。

レイアウトからスライドを作成する前に、必要なプレースホルダーをレイアウトに追加してください。後からレイアウトに別のプレースホルダーを追加しても、既存の通常スライドに自動的に対応するプレースホルダー図形は追加されません。

この関係には重要な結果が 2 つあります。

レイアウト上の継承書式や既存プレースホルダーのジオメトリを変更すると、それに依存するすべてのスライドが更新されます。既に使用中のレイアウトを編集する前に、依存スライドを確認し、結果のプレゼンテーションをレビューしてください。
スライドで使用中のレイアウトは削除できません。先に依存スライドを別のレイアウトに再割り当てするか、未使用のレイアウトのみを削除してください。

この階層の最上位レベルの詳細については、 Slide Master を参照してください。

1 枚のスライドまたは共有レイアウト上で継承ロゴや装飾的なマスター図形を非表示にする方法については、 Control the Visibility of Master Graphics を参照してください。例では、同じマスターを使用する 2 枚のスライドを比較しています。

スライドレイアウトの選択と適用

プレゼンテーションが標準の PowerPoint レイアウト定義に従う場合は、 SlideLayoutType 値を使用します。レイアウト名はユーザーが編集でき、ローカライズ可能なため、テンプレートのソースを管理できない限り、名前ベースの選択は信頼性が低くなります。

次の例は、最初のマスターで Title and Content を検索します。そのレイアウトが利用できない場合は、意図的に Blank にフォールバックします。2 回目の null チェックは、プレゼンテーションにカスタムレイアウトのみが含まれる可能性があるために必要です。選択されたレイアウトは、 Slide.setLayoutSlide メソッドを介して最初の通常スライドに適用されます。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    let titleAndObjectLayoutType = java.newByte(aspose.slides.SlideLayoutType.TitleAndObject);
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let targetLayout = layoutSlides.getByType(titleAndObjectLayoutType);

    if (targetLayout === null) {
        targetLayout = layoutSlides.getByType(blankLayoutType);
    }

    if (targetLayout === null) {
        throw new Error("The first master does not contain a suitable layout slide.");
    }

    presentation.getSlides().get_Item(0).setLayoutSlide(targetLayout);
    presentation.save("output-with-new-layout.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

スライドのレイアウトを変更しても、スライドに直接追加された通常の図形は削除されません。ただし、プレースホルダーの位置、継承書式、および既存プレースホルダーと新レイアウト間の対応が変わる可能性があるため、レイアウトが大きく異なる場合は出力を確認してください。

レイアウトスライドの追加

選択と作成は別々の操作です。前の例は既存レイアウトを選択しただけで、作成は行っていません。レイアウトを作成するには、対象マスターのレイアウトコレクションで MasterLayoutSlideCollection.add メソッドを呼び出します。

次の例は常に Title and Content レイアウトを Report Title and Content という名前で新規追加し、そのレイアウトに基づく通常スライドを追加します。レイアウト名はコレクション内で一意である必要があります。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let masterSlide = presentation.getMasters().get_Item(0);
    let titleAndObjectLayoutType = java.newByte(aspose.slides.SlideLayoutType.TitleAndObject);
    let reportLayout = masterSlide.getLayoutSlides().add(titleAndObjectLayoutType, "Report Title and Content");
    presentation.getSlides().addEmptySlide(reportLayout);

    presentation.save("output-with-report-layout.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

テンプレートが本当に別の再利用可能構造を必要とする場合にのみレイアウトを追加してください。適切なレイアウトがすでに存在する場合は、作成して重複させるのではなく、選択して再利用してください。

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

LayoutSlide.getPlaceholderManager メソッドは、レイアウトにプレースホルダー図形を追加するための LayoutPlaceholderManager を提供します。

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

次の例は Blank レイアウトの存在を確認し、4 つのプレースホルダーを追加してから、変更されたレイアウトを使用する通常スライドを作成します。順序は意図的で、プレースホルダーは通常スライド作成前に追加されるため、Aspose.Slides がそのスライド上に対応するプレースホルダー図形を生成できます。

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

let presentation = new aspose.slides.Presentation();
try {
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let blankLayout = presentation.getLayoutSlides().getByType(blankLayoutType);

    if (blankLayout === null) {
        throw new Error("The presentation does not contain a Blank layout slide.");
    }

    let placeholderManager = blankLayout.getPlaceholderManager();
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    presentation.getSlides().addEmptySlide(blankLayout);
    presentation.save("output-with-placeholders.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

レイアウトスライド上のプレースホルダー

Warning

継承書式や既存レイアウトプレースホルダーのジオメトリを変更すると、依存スライドに影響を与える可能性があります。新しく追加されたレイアウトプレースホルダーは既存の通常スライドには自動的に反映されません。レイアウトの変更はプレゼンテーションのコピー上でテストし、すべての依存スライドを確認してください。

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

Compress.removeUnusedLayoutSlides メソッドを使用して、通常スライドが参照していないレイアウトを削除します。このメソッドは、まだ使用中のレイアウトはそのまま残します。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    aspose.slides.Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("output-without-unused-layouts.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

特定のレイアウトを削除するには、まずそのレイアウトの hasDependingSlides または getDependingSlides メソッドを使用します。依存スライドを別のレイアウトに再割り当ててから LayoutSlide.remove を呼び出してください。使用中のレイアウトを削除しようとすると、 PptxEditException がスローされます。

レイアウトスライド上のフッター表示の制御

レイアウトには独自のフッター、スライド番号、日付時刻プレースホルダーがあります。これらのプレースホルダーをレイアウト単位で制御するには、 LayoutSlide.getHeaderFooterManager メソッドを使用します。たとえば、コンテンツレイアウトではフッターを表示し、タイトルレイアウトでは表示しないといったシナリオに便利です。

次の例はレイアウトを安全に選択し、フッター要素を表示可能にします。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let titleAndObjectLayoutType = java.newByte(aspose.slides.SlideLayoutType.TitleAndObject);
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let layoutSlide = presentation.getLayoutSlides().getByType(titleAndObjectLayoutType);

    if (layoutSlide === null) {
        layoutSlide = presentation.getLayoutSlides().getByType(blankLayoutType);
    }

    if (layoutSlide === null) {
        throw new Error("The presentation does not contain a suitable layout slide.");
    }

    let headerFooterManager = layoutSlide.getHeaderFooterManager();
    headerFooterManager.setFooterVisibility(true);
    headerFooterManager.setSlideNumberVisibility(true);
    headerFooterManager.setDateTimeVisibility(true);
    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

    presentation.save("output-with-layout-footers.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

マスターとその子レイアウト上のフッター表示の制御

マスター階層全体で一貫したフッター設定を適用するには、 MasterSlide.getHeaderFooterManager メソッドを使用します。 MasterSlideHeaderFooterManager の伝播メソッドはマスターとその依存レイアウトスライドおよび通常スライドに作用し、単一の通常スライドだけを対象にすることはできません。

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

let presentation = new aspose.slides.Presentation("input.pptx");
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-with-master-footers.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

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

マスタースライドはプレゼンテーションのテーマと共有書式を定義します。レイアウトスライドはマスターに属し、プレースホルダーの再利用可能な配置を 1 つ定義します。通常スライドはこれらのレイアウトを使用し、スライド固有のコンテンツを保存します。

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

はい。目的のコレクションに対して addClone メソッドでコピーを追加します。プレゼンテーション間でコピーする場合は、フォント、テーマ、画像、その他のリソースがソースレイアウトで使用されているかも確認してください。

使用中のレイアウトを変更するとどうなりますか？

依存スライドはレイアウト変更を継承しますが、ローカルで書式やオブジェクトを上書きしている場合は除外されます。プレースホルダーのジオメトリや継承スタイルが多数のスライドで同時に変わる可能性があります。レイアウトを編集する前に、 getDependingSlides で影響を受けるスライドを特定してください。

使用中のレイアウトを削除しようとするとどうなりますか？

Aspose.Slides は PptxEditException をスローします。まず依存スライドを別のレイアウトに再割り当てるか、 removeUnusedLayoutSlides を使用して参照されていないレイアウトだけを削除してください。

プレゼンテーションビューア JavaScript でプレゼンテーションプロパティを管理する

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

このページの概要

概要

レイアウト継承の理解

スライド レイアウトの選択と適用

レイアウト スライドの追加

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