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

概要

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

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

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

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

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

Aspose.Slides for Android でスライドレイアウトを操作するには、次のものを使用できます。

Presentation クラスの下にある get_LayoutSlides や get_Masters などのメソッド
ILayoutSlide、IMasterLayoutSlideCollection、ILayoutPlaceholderManager、ILayoutSlideHeaderFooterManager などの型

Info

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

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

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

Presentation クラスのインスタンスを作成します。
IMasterLayoutSlideCollection にアクセスします。
希望するレイアウトスライドがコレクションに既に存在するか確認します。存在しない場合は必要なレイアウトスライドを追加します。
新しいレイアウトスライドに基づいて空のスライドを追加します。
プレゼンテーションを保存します。

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

// PowerPoint ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"Sample.pptx");

// Go through the layout slide types to select a layout slide.
auto layoutSlides = presentation->get_Master(0)->get_LayoutSlides();
SharedPtr<ILayoutSlide> layoutSlide;
if (layoutSlides->GetByType(SlideLayoutType::TitleAndObject) != nullptr)
{
    layoutSlide = layoutSlides->GetByType(SlideLayoutType::TitleAndObject);
}
else if (layoutSlides->GetByType(SlideLayoutType::Title) != nullptr)
{
    layoutSlide = layoutSlides->GetByType(SlideLayoutType::Title);
}

if (layoutSlide == nullptr)
{
    // プレゼンテーションにすべてのレイアウトタイプが含まれていない状況です。
    // プレゼンテーション ファイルには Blank と Custom のレイアウト タイプのみが含まれています。
    // ただし、カスタムタイプのレイアウトスライドは認識可能な名前を持つ場合があります、
    // 例えば "Title"、"Title and Content" などで、レイアウトスライドの選択に使用できます。
    // プレースホルダー シェイプ タイプのセットに頼ることもできます。
    // 例えば、Title スライドは Title プレースホルダー タイプだけを持つべきです、など。
    for (int i = 0; i < layoutSlides->get_Count(); i++)
    {
        auto titleAndObjectLayoutSlide = layoutSlides->idx_get(i);

        if (titleAndObjectLayoutSlide->get_Name().Equals(u"Title and Object"))
        {
            layoutSlide = titleAndObjectLayoutSlide;
            break;
        }
    }

    if (layoutSlide == nullptr)
    {
        for (int i = 0; i < layoutSlides->get_Count(); i++)
        {
            auto titleLayoutSlide = layoutSlides->idx_get(i);

            if (titleLayoutSlide->get_Name() == u"Title")
            {
                layoutSlide = titleLayoutSlide;
                break;
            }
        }

        if (layoutSlide == nullptr)
        {
            layoutSlide = layoutSlides->GetByType(SlideLayoutType::Blank);
            if (layoutSlide == nullptr)
            {
                layoutSlide = layoutSlides->Add(SlideLayoutType::TitleAndObject, u"Title and Object");
            }
        }
    }
}

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

// Save the presentation to disk.
presentation->Save(u"Output.pptx", SaveFormat::Pptx);
presentation->Dispose();

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

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

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

auto presentation = MakeObject<Presentation>(u"Presentation.pptx");

Compress::RemoveUnusedLayoutSlides(presentation);

presentation->Save(u"Output.pptx", SaveFormat::Pptx);
presentation->Dispose();

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

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

このマネージャーには、次のプレースホルダータイプ用のメソッドが含まれています。

PowerPoint プレースホルダー	ILayoutPlaceholderManager Method
	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)

以下の C++ コードは、ブランクレイアウトスライドに新しいプレースホルダーシェイプを追加する方法を示しています。

auto presentation = MakeObject<Presentation>();

// Blank レイアウトスライドを取得します。
auto layout = presentation->get_LayoutSlides()->GetByType(SlideLayoutType::Blank);

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

// 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);

// Add a new slide with the Blank layout.
auto newSlide = presentation->get_Slides()->AddEmptySlide(layout);

presentation->Save(u"Placeholders.pptx", SaveFormat::Pptx);
presentation->Dispose();

結果:

The placeholders on the layout slide

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

PowerPoint プレゼンテーションでは、日付、スライド番号、カスタムテキストなどのフッター要素は、スライドレイアウトに応じて表示・非表示を切り替えることができます。Aspose.Slides for Android を使用すると、これらのフッタープレースホルダーの表示状態を制御できます。特定のレイアウトでフッター情報を表示し、他のレイアウトではシンプルに保ちたい場合に便利です。

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

以下の C++ コードは、スライドフッターの表示状態を設定し、関連タスクを実行する方法を示しています。

auto presentation = MakeObject<Presentation>(u"Presentation.ppt");
auto headerFooterManager = presentation->get_LayoutSlides()->idx_get(0)->get_HeaderFooterManager();

if (!headerFooterManager->get_IsFooterVisible())
{
    headerFooterManager->SetFooterVisibility(true);
}

if (!headerFooterManager->get_IsSlideNumberVisible())
{
    headerFooterManager->SetSlideNumberVisibility(true);
}

if (!headerFooterManager->get_IsDateTimeVisible())
{
    headerFooterManager->SetDateTimeVisibility(true);
}

headerFooterManager->SetFooterText(u"Footer text");
headerFooterManager->SetDateTimeText(u"Date and time text");

presentation->Save(u"Presentation.ppt", SaveFormat::Pptx);
presentation->Dispose();

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

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

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

以下の C++ コードは、この操作を実演しています。

auto presentation = MakeObject<Presentation>();

auto headerFooterManager = presentation->get_Master(0)->get_HeaderFooterManager();

headerFooterManager->SetFooterAndChildFootersVisibility(true);
headerFooterManager->SetSlideNumberAndChildSlideNumbersVisibility(true);
headerFooterManager->SetDateTimeAndChildDateTimesVisibility(true);

headerFooterManager->SetFooterAndChildFootersText(u"Footer text");
headerFooterManager->SetDateTimeAndChildDateTimesText(u"Date and time text");

presentation->Save(u"Output.pptx", SaveFormat::Pptx);
presentation->Dispose();

FAQ

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

マスタースライドは全体のテーマと既定の書式設定を定義し、レイアウトスライドは異なるコンテンツタイプ向けにプレースホルダーの具体的な配置を定義します。

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

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

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

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

C++でプレゼンテーションスライドを比較する C++でプレゼンテーションのスライドサイズを変更する

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

概要

Info

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

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

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

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

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

FAQ

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

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

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

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