C++ でプレゼンテーションのヘッダーとフッターを管理する

このページの概要

Aspose.Slides for C++ を使用して、スライド、ノートページ、配布資料のフッター、日付/時刻、スライド番号、ヘッダープレースホルダーを管理する方法を学びます。

概要

PowerPoint はページの種類に応じて異なるヘッダーおよびフッタープレースホルダーを使用します。Aspose.Slides for C++ は、ヘッダー/フッターマネージャーインターフェイスを介してこれらのプレースホルダーのテキストと表示状態を制御できます。

利用可能なプレースホルダーはスコープによって異なります:

範囲	ヘッダー	フッター	日付/時刻	スライド/ページ番号
通常スライド	なし	あり	あり	あり
ノートマスター	あり	あり	あり	あり
ノートスライド	あり	あり	あり	あり
配布資料マスター	あり	あり	あり	あり

通常のプレゼンテーションスライドにはヘッダープレースホルダーがありません。ヘッダーはノートページと配布資料で利用可能です。通常スライドでは、フッター、日付/時刻、スライド番号のプレースホルダーを使用してください。

変更のスコープは使用するマネージャーによって決まります。ISlideHeaderFooterManager インターフェイスは 1 枚の通常スライドを制御します。INotesSlideHeaderFooterManager インターフェイスは 1 枚のノートスライドを制御します。マスターおよびレイアウトマネージャーは設定を依存スライドに伝搬させることができ、IMasterHandoutSlideHeaderFooterManager インターフェイスは配布資料マスターを制御します。

通常スライドのフッター、日付/時刻、スライド番号の設定

通常スライドの場合、基本的な手順は各スライドのヘッダー/フッターマネージャーにアクセスし、フッターと日付/時刻のテキストを設定し、必要なプレースホルダーを有効にしてプレゼンテーションを保存することです。スライド番号はプレゼンテーションが自動的に生成するため、表示状態のみを制御すればよいです。

テキストの設定には SetFooterText と SetDateTimeText を使用し、対応するプレースホルダーの表示は SetFooterVisibility、SetDateTimeVisibility、SetSlideNumberVisibility で制御します。

以下のエンドツーエンド例は、すべての通常スライドに同じフッター、日付/時刻テキスト、スライド番号の表示を適用します:

#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideHeaderFooterManager.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/enumerator_adapter.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

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

for (const auto& slide : System::IterateOver(presentation->get_Slides()))
{
    auto headerFooterManager = slide->get_HeaderFooterManager();

    headerFooterManager->SetFooterText(u"Company Confidential");
    headerFooterManager->SetFooterVisibility(true);

    headerFooterManager->SetDateTimeText(u"Date and time text");
    headerFooterManager->SetDateTimeVisibility(true);

    headerFooterManager->SetSlideNumberVisibility(true);
}

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

1 枚だけ更新したい場合は、スライドコレクション全体を列挙する代わりに Presentation::get_Slide で対象スライドに直接アクセスしてください。

ノートマスターのヘッダーとフッターの設定

ノートマスターはノートページ全体の書式設定とプレースホルダーの動作を定義します。ノートマスター自体のみを変更したい場合は、IMasterNotesSlideHeaderFooterManager インターフェイスを使用します。

次の例はノートマスターにヘッダー、フッター、日付/時刻テキストを設定し、そのマスター上のすべてのサポート対象プレースホルダーを表示可能にします:

#include <DOM/IMasterNotesSlide.h>
#include <DOM/IMasterNotesSlideHeaderFooterManager.h>
#include <DOM/IMasterNotesSlideManager.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"presentation.pptx");
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();

if (masterNotesSlide != nullptr)
{
    auto headerFooterManager = masterNotesSlide->get_HeaderFooterManager();

    headerFooterManager->SetHeaderText(u"Notes header");
    headerFooterManager->SetHeaderVisibility(true);

    headerFooterManager->SetFooterText(u"Notes footer");
    headerFooterManager->SetFooterVisibility(true);

    headerFooterManager->SetDateTimeText(u"Date and time text");
    headerFooterManager->SetDateTimeVisibility(true);

    headerFooterManager->SetSlideNumberVisibility(true);
}

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

ノートマスターが存在しないプレゼンテーションの場合、IMasterNotesSlideManager::get_MasterNotesSlide は nullptr を返します。

ノートマスター設定の子ノートスライドへの適用

ノートマスターは自身およびすべての依存ノートスライドにヘッダーとフッターの設定を適用できます。ノート階層全体に同じ設定を適用する場合は、IMasterNotesSlideHeaderFooterManager の専用伝搬メソッドを使用してください。

例えば、SetHeaderAndChildHeadersText と SetHeaderAndChildHeadersVisibility はノートマスターのヘッダーとすべての子ヘッダーを更新します。フッター、日付/時刻、スライド番号についても同様のメソッドが用意されています。

#include <DOM/IMasterNotesSlide.h>
#include <DOM/IMasterNotesSlideHeaderFooterManager.h>
#include <DOM/IMasterNotesSlideManager.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"presentation.pptx");
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();

if (masterNotesSlide != nullptr)
{
    auto headerFooterManager = masterNotesSlide->get_HeaderFooterManager();

    headerFooterManager->SetHeaderAndChildHeadersText(u"Notes header");
    headerFooterManager->SetHeaderAndChildHeadersVisibility(true);

    headerFooterManager->SetFooterAndChildFootersText(u"Notes footer");
    headerFooterManager->SetFooterAndChildFootersVisibility(true);

    headerFooterManager->SetDateTimeAndChildDateTimesText(u"Date and time text");
    headerFooterManager->SetDateTimeAndChildDateTimesVisibility(true);

    headerFooterManager->SetSlideNumberAndChildSlideNumbersVisibility(true);
}

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

上記で使用した伝搬メソッドは SetFooterAndChildFootersText、SetFooterAndChildFootersVisibility、SetDateTimeAndChildDateTimesText、SetDateTimeAndChildDateTimesVisibility、SetSlideNumberAndChildSlideNumbersVisibility です。

個別ノートスライドのヘッダーとフッターの設定

ノートスライドは特定の通常スライドに紐づきます。そのノートページだけをカスタマイズしたい場合は、INotesSlideHeaderFooterManager インターフェイスを使用してください。

INotesSlideManager::AddNotesSlide メソッドは現在のスライドに対するノートスライドを返し、存在しない場合は作成します。次の例は最初のプレゼンテーションスライドに関連付けられたノートページを構成します:

#include <DOM/INotesSlide.h>
#include <DOM/INotesSlideHeaderFooterManager.h>
#include <DOM/INotesSlideManager.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"presentation.pptx");
auto slide = presentation->get_Slide(0);
auto notesSlide = slide->get_NotesSlideManager()->AddNotesSlide();
auto headerFooterManager = notesSlide->get_HeaderFooterManager();

headerFooterManager->SetHeaderText(u"Header for the first notes page");
headerFooterManager->SetHeaderVisibility(true);

headerFooterManager->SetFooterText(u"Footer for the first notes page");
headerFooterManager->SetFooterVisibility(true);

headerFooterManager->SetDateTimeText(u"Date and time text");
headerFooterManager->SetDateTimeVisibility(true);

headerFooterManager->SetSlideNumberVisibility(true);

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

まずノートマスターから設定を伝搬させ、その後個別ノートスライドを変更すると、後者のスライド固有設定でそのノートページを独立してカスタマイズできます。

配布資料マスターのヘッダーとフッターの設定

配布資料ページはヘッダー、フッター、日付/時刻、ページ番号プレースホルダーに配布資料マスターを使用します。ノートページとは異なり、配布資料の設定は個別スライドではなく配布資料マスターを介して管理されます。

配布資料マスターにアクセスするには IMasterHandoutSlideManager::get_MasterHandoutSlide を使用します。存在しない場合は IMasterHandoutSlideManager::SetDefaultMasterHandoutSlide を呼び出してデフォルトの配布資料マスターを作成してください。

#include <DOM/IMasterHandoutSlide.h>
#include <DOM/IMasterHandoutSlideHeaderFooterManager.h>
#include <DOM/IMasterHandoutSlideManager.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"presentation.pptx");
auto masterHandoutSlideManager = presentation->get_MasterHandoutSlideManager();
auto masterHandoutSlide = masterHandoutSlideManager->get_MasterHandoutSlide();

if (masterHandoutSlide == nullptr)
{
    masterHandoutSlide = masterHandoutSlideManager->SetDefaultMasterHandoutSlide();
}

if (masterHandoutSlide != nullptr)
{
    auto headerFooterManager = masterHandoutSlide->get_HeaderFooterManager();

    headerFooterManager->SetHeaderText(u"Handout header");
    headerFooterManager->SetHeaderVisibility(true);

    headerFooterManager->SetFooterText(u"Handout footer");
    headerFooterManager->SetFooterVisibility(true);

    headerFooterManager->SetDateTimeText(u"Date and time text");
    headerFooterManager->SetDateTimeVisibility(true);

    headerFooterManager->SetSlideNumberVisibility(true);
}

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

スコープと継承の理解

変更したいスコープに合ったヘッダー/フッターマネージャーを選択してください:

ISlideHeaderFooterManager は 1 枚の通常スライドのフッター、日付/時刻、スライド番号設定を変更します。
ILayoutSlideHeaderFooterManager はレイアウトスライドを制御し、サポート対象設定を依存スライドに伝搬できます。
IMasterSlideHeaderFooterManager は通常スライドマスターを制御し、サポート対象設定を依存スライドに伝搬できます。
IMasterNotesSlideHeaderFooterManager はノートマスターを制御し、すべての依存ノートスライドに設定を伝搬できます。
INotesSlideHeaderFooterManager は 1 枚のノートスライドを変更し、フッター、日付/時刻、スライド番号に加えてヘッダープレースホルダーもサポートします。
IMasterHandoutSlideHeaderFooterManager は配布資料マスターを変更し、4 つのプレースホルダーすべてをサポートします。

同じ設定を階層全体に適用したい場合は、マスターまたはレイアウトから伝搬させます。1 ページだけローカル設定が必要な場合は、個別スライドまたはノートスライドマネージャーを使用してください。

FAQ

通常スライドにヘッダーを追加できますか？

いいえ。PowerPoint は通常スライドにヘッダープレースホルダーを定義していません。通常スライドではフッター、日付/時刻、スライド番号プレースホルダーを使用してください。ヘッダープレースホルダーはノートページと配布資料で利用可能です。

フッター、日付/時刻、またはスライド番号プレースホルダーが表示されない場合はどうすればよいですか？

対応するヘッダー/フッターマネージャーで可視性を確認し、必要に応じて有効にします。たとえば、get_IsFooterVisible はフッタープレースホルダーの有無を示し、SetFooterVisibility で可視性を変更できます。

スライド番号を 1 以外の値から開始するにはどうすればよいですか？

Presentation::set_FirstSlideNumber を使用して最初のスライド番号を設定します。その後、スライド番号プレースホルダーは更新された番号付けシーケンスを使用します。

PDF、画像、HTML へエクスポートした際にヘッダーとフッターはどうなりますか？

表示されているヘッダーとフッター要素は、出力形式のプレゼンテーションコンテンツと共にレンダリングされます。その外観はエクスポート対象のページタイプと対応するプレースホルダーの可視性設定に依存します。

PowerPoint フォント