PowerPointスライドのヘッダーセクションとフッターセクションを使用して、スライド番号、日付、作成者などの追加情報を表示できます。また、C++アプリケーション内でこれらのセクションをプログラムで操作することもできます。そのために、この記事では、C++を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する方法を説明します。
- PowerPointプレゼンテーションにヘッダーとフッターを追加するためのC++API
- C++を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する
- C++を使用してNotesマスターとNotesスライドのヘッダーとフッターを管理する
PowerPointプレゼンテーションにヘッダーとフッターを追加するためのC++API
Aspose.Slides for C++ APIを使用して、PowerPointプレゼンテーションにヘッダーとフッターを追加します。これは、PowerPoint PPTX/PPTファイルを操作するための多くの機能を提供する堅牢なAPIです。 APIは、NuGetからインストールするか、ダウンロードセクションから直接ダウンロードできます。
PM> Install-Package Aspose.Slides.Cpp
C++を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する
以下は、PowerPointプレゼンテーションにヘッダーとフッターを追加するための手順です。
- まず、Presentationクラスを使用してPowerPointファイルをロードします。
- Presentation->get_HeaderFooterManager()->SetAllFootersText(System::String text)メソッドを使用してフッターテキストを設定します。
- Presentation->get_HeaderFooterManager()->SetAllFootersVisibility(bool isVisible)メソッドを使用して可視性を設定することにより、フッターを表示します。
- Presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide()メソッドを使用して、マスターノートスライドにアクセスします。
- マスターノートスライドの形状をループします。
- 図形のタイプがPlaceholderType::Headerの場合、IAutoShape->get_TextFrame()->set_Text(System::String value)メソッドを使用してヘッダーテキストを設定します。
- 最後に、Presentation->Save(System::String fname, Export::SaveFormat format)メソッドを使用してプレゼンテーションを保存します。
次のサンプルコードは、C++を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する方法を示しています。
// ファイルパス
const String sourceFilePath = u"SourceDirectory\\Slides\\Presentation2.pptx";
const String outputFilePath = u"OutputDirectory\\AddHeaderFooter_out.pptx";
// プレゼンテーションファイルをロードする
SharedPtr<Presentation> presentation = MakeObject<Presentation>(sourceFilePath);
// フッターの設定
presentation->get_HeaderFooterManager()->SetAllFootersText(u"My Footer text");
presentation->get_HeaderFooterManager()->SetAllFootersVisibility(true);
// ヘッダーへのアクセスと更新
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();
if (nullptr != masterNotesSlide)
{
for (const auto& shape : System::IterateOver(masterNotesSlide->get_Shapes()))
{
if (shape->get_Placeholder() != nullptr)
{
if (shape->get_Placeholder()->get_Type() == PlaceholderType::Header)
{
(System::DynamicCast<IAutoShape>(shape))->get_TextFrame()->set_Text(u"HI there new header");
}
}
}
}
// プレゼンテーションを保存
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
C++を使用してNotesマスターとNotesスライドのヘッダーとフッターを管理する
Aspose.Slides for C++を使用すると、ノートマスタースライドとノートスライドの両方のヘッダーとフッターを簡単に管理できます。次のセクションでは、ノートマスターとノートスライドでヘッダーとフッターを管理する方法について説明します。
ノートマスターのヘッダーとフッターの設定を変更する
ノートマスターのヘッダーとフッターの設定を変更する手順は次のとおりです。
- まず、Presentationクラスを使用してPowerPointファイルをロードします。
- Presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide()メソッドを使用して、マスターノートスライドにアクセスします。
- IMasterNotesSlide->get_HeaderFooterManager()メソッドを使用して、IMasterNotesSlideHeaderFooterManagerにアクセスします。
- IMasterNotesSlideHeaderFooterManagerオブジェクトを使用して、ヘッダーとフッターを更新します。
- 最後に、Presentation->Save(System::String fname, Export::SaveFormat format)メソッドを使用してプレゼンテーションを保存します。
次のサンプルコードは、C++を使用してノートマスターのヘッダーとフッターを変更する方法を示しています。
// ファイルパス
const String sourceFilePath = u"OutputDirectory\\AddHeaderFooter_out.pptx";
const String outputFilePath = u"OutputDirectory\\ChangeHeaderFooterNotesMaster_out.pptx";
// プレゼンテーションファイルをロードする
SharedPtr<Presentation> presentation = MakeObject<Presentation>(sourceFilePath);
// ノートマスターとすべてのノートスライドのヘッダーとフッターの設定を変更する
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();
if (masterNotesSlide != nullptr)
{
auto headerFooterManager = masterNotesSlide->get_HeaderFooterManager();
// マスターノートをスライドさせ、すべての子Footerプレースホルダーを表示します
headerFooterManager->SetHeaderAndChildHeadersVisibility(true);
// マスターノートをスライドさせ、すべての子ヘッダープレースホルダーを表示します
headerFooterManager->SetFooterAndChildFootersVisibility(true);
// マスターノートをスライドさせ、すべての子SlideNumberプレースホルダーを表示します
headerFooterManager->SetSlideNumberAndChildSlideNumbersVisibility(true);
// マスターノートをスライドさせ、すべての子の日付と時刻のプレースホルダーを表示します
headerFooterManager->SetDateTimeAndChildDateTimesVisibility(true);
// テキストをマスターノートスライドとすべての子ヘッダープレースホルダーに設定します
headerFooterManager->SetHeaderAndChildHeadersText(u"Header text");
// テキストをマスターノートスライドとすべての子フッタープレースホルダーに設定します
headerFooterManager->SetFooterAndChildFootersText(u"Footer text");
// マスターノートスライドとすべての子の日付と時刻のプレースホルダーにテキストを設定します
headerFooterManager->SetDateTimeAndChildDateTimesText(u"Date and time text");
}
// プレゼンテーションを保存
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
ノートスライドのヘッダーとフッターの設定を変更する
以下は、ノートスライドのヘッダーとフッターの設定を変更する手順です。
- まず、Presentationクラスを使用してPowerPointファイルをロードします。
- Presentation->get_Slides()->idx_get(0)->get_NotesSlideManager()->get_NotesSlide()メソッドを使用してメモスライドにアクセスします。
- INotesSlide->get_HeaderFooterManager()メソッドを使用して、INotesSlideHeaderFooterManagerにアクセスします。
- INotesSlideHeaderFooterManagerオブジェクトを使用して、ヘッダーとフッターを更新します。
- 最後に、Presentation->Save(System::String fname, Export::SaveFormat format)メソッドを使用してプレゼンテーションを保存します。
次のサンプルコードは、C++を使用してノートスライドのヘッダーとフッターを変更する方法を示しています。
// ファイルパス
const String sourceFilePath = u"OutputDirectory\\ChangeHeaderFooterNotesMaster_out.pptx";
const String outputFilePath = u"OutputDirectory\\ChangeHeaderFooterNotesSlide_out.pptx";
// プレゼンテーションファイルをロードする
SharedPtr<Presentation> presentation = MakeObject<Presentation>(sourceFilePath);
// 最初のノートスライドのみのヘッダーとフッターの設定を変更する
auto notesSlide = presentation->get_Slides()->idx_get(0)->get_NotesSlideManager()->get_NotesSlide();
if (notesSlide != nullptr)
{
auto headerFooterManager = notesSlide->get_HeaderFooterManager();
if (!headerFooterManager->get_IsHeaderVisible())
{
// このメモのスライドヘッダープレースホルダーを表示する
headerFooterManager->SetHeaderVisibility(true);
}
if (!headerFooterManager->get_IsFooterVisible())
{
// このメモをスライドフッタープレースホルダーに表示します
headerFooterManager->SetFooterVisibility(true);
}
if (!headerFooterManager->get_IsSlideNumberVisible())
{
// このメモのスライドSlideNumberプレースホルダーを表示します
headerFooterManager->SetSlideNumberVisibility(true);
}
if (!headerFooterManager->get_IsDateTimeVisible())
{
// このメモをスライドする日時プレースホルダーを表示する
headerFooterManager->SetDateTimeVisibility(true);
}
// メモスライドヘッダープレースホルダーにテキストを設定
headerFooterManager->SetHeaderText(u"New header text");
// メモにテキストを設定するスライドフッタープレースホルダー
headerFooterManager->SetFooterText(u"New footer text");
// テキストをメモスライドに設定日時プレースホルダー
headerFooterManager->SetDateTimeText(u"New date and time text");
}
// プレゼンテーションを保存
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
無料ライセンスを取得する
評価の制限なしにAPIを試すために、無料の一時ライセンスをリクエストできます。
結論
この記事では、C++を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する方法を学習しました。さらに、Aspose.Slides for C++ APIを使用して、ノートマスターとノートスライドのヘッダーとフッターを変更する方法を確認しました。これは、PowerPoint PPTX/PPTファイルを操作するための一連の追加機能を提供する強力なAPIです。 公式ドキュメントにアクセスすると、APIの詳細を調べることができます。ご不明な点がございましたら、無料サポートフォーラムまでお気軽にお問い合わせください。