PowerPointプレゼンテーションのヘッダーとフッターは、スライド番号、作成者、日付などの追加情報を表示するために使用されます。この記事では、C#を使用してプログラムでPowerPoint PPTX/PPTプレゼンテーションのヘッダーとフッターを追加および管理する方法を学習します。
PowerPointでヘッダーとフッターを管理するための.NET API
PowerPointプレゼンテーションでヘッダーとフッターを操作するために、Aspose.Slides for .NETを使用します。これは、PowerPointおよびOpenOfficeドキュメントを作成および操作できる.NETクラスライブラリです。 APIのDLLは、ダウンロードセクションからダウンロードできます。また、APIはNuGetを介してインストールできます。
PM> Install-Package Aspose.Slides.NET
C#を使用してPowerPointにヘッダーとフッターを追加する
以下は、C#を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する手順です。
- まず、Presentationクラスを使用して、新しいプレゼンテーションを作成するか、既存のプレゼンテーションをロードします。
- 次に、Presentation.HeaderFooterManager.SetAllFootersText(string)メソッドを使用してフッターを設定します。
- Presentation.MasterNotesSlideManager.MasterNotesSlideプロパティを使用して、IMasterNotesSlideオブジェクトのマスターノートスライドにアクセスします。
- IMasterNotesSlide.Shapesコレクションの各図形をループします。
- IShape.Placeholder.TypeがPlaceholderType.Headerの場合、((IAutoShape)shape).TextFrame.Textプロパティを使用してヘッダーのテキストを設定します。
- 最後に、Presentation.Save(string, SaveFormat)メソッドを使用してプレゼンテーションを保存します。
次のコードサンプルは、PowerPointプレゼンテーションにヘッダーとフッターを追加する方法を示しています。
// プレゼンテーションを読み込む
Presentation pres = new Presentation("headerTest.pptx");
// フッターを設定する
pres.HeaderFooterManager.SetAllFootersText("My Footer text");
pres.HeaderFooterManager.SetAllFootersVisibility(true);
// ヘッダーへのアクセスと更新
IMasterNotesSlide masterNotesSlide = pres.MasterNotesSlideManager.MasterNotesSlide;
if (null != masterNotesSlide)
{
foreach (IShape shape in masterNotesSlide.Shapes)
{
if (shape.Placeholder != null)
{
if (shape.Placeholder.Type == PlaceholderType.Header)
{
((IAutoShape)shape).TextFrame.Text = "HI there new header";
}
}
}
}
// プレゼンテーションを保存する
pres.Save("HeaderFooter.pptx", SaveFormat.Pptx);
C#を使用して配布物とメモスライドのヘッダーとフッターを管理する
Aspose.Slides for .NETでは、配布物とメモのスライドにヘッダーとフッターを設定することもできます。このために、マスターノートスライドまたは個々のスライドに変更を適用できます。次のセクションでは、両方のシナリオについて説明します。
ノートマスターのヘッダーとフッターの設定を変更する
- まず、Presentationクラスを使用して、新しいプレゼンテーションを作成するか、既存のプレゼンテーションをロードします。
- 次に、Presentation.MasterNotesSlideManager.MasterNotesSlideプロパティを使用して、IMasterNotesSlideオブジェクトのマスターノートスライドにアクセスします。
- IMasterNotesSlide.HeaderFooterManagerプロパティからIMasterNotesSlideHeaderFooterManagerの参照を取得します。
- IMasterNotesSlideHeaderFooterManagerオブジェクトを使用してヘッダーフッターを更新します。
- 最後に、Presentation.Save(string, SaveFormat)メソッドを使用してプレゼンテーションを保存します。
次のコードサンプルは、C#を使用してノートマスターのヘッダーとフッターを変更する方法を示しています。
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// ノートマスターとすべてのノートスライドのヘッダーとフッターの設定を変更する
IMasterNotesSlide masterNotesSlide = presentation.MasterNotesSlideManager.MasterNotesSlide;
if (masterNotesSlide != null)
{
IMasterNotesSlideHeaderFooterManager headerFooterManager = masterNotesSlide.HeaderFooterManager;
headerFooterManager.SetHeaderAndChildHeadersVisibility(true); // make the master notes slide and all child Footer placeholders visible
headerFooterManager.SetFooterAndChildFootersVisibility(true); // make the master notes slide and all child Header placeholders visible
headerFooterManager.SetSlideNumberAndChildSlideNumbersVisibility(true); // make the master notes slide and all child SlideNumber placeholders visible
headerFooterManager.SetDateTimeAndChildDateTimesVisibility(true); // make the master notes slide and all child Date and time placeholders visible
headerFooterManager.SetHeaderAndChildHeadersText("Header text"); // set text to master notes slide and all child Header placeholders
headerFooterManager.SetFooterAndChildFootersText("Footer text"); // set text to master notes slide and all child Footer placeholders
headerFooterManager.SetDateTimeAndChildDateTimesText("Date and time text"); // set text to master notes slide and all child Date and time placeholders
}
// プレゼンテーションを保存する
presentation.Save("testresult.pptx",SaveFormat.Pptx);
}
ノートスライドのヘッダーとフッターの設定を変更する
- まず、Presentationクラスを使用して、新しいプレゼンテーションを作成するか、既存のプレゼンテーションをロードします。
- 次に、Presentation.Slides[index].NotesSlideManager.NotesSlideプロパティを使用して、目的のスライドのINotesSlideオブジェクトにアクセスします。
- INotesSlide.HeaderFooterManagerプロパティからINotesSlideHeaderFooterManagerの参照を取得します。
- INotesSlideHeaderFooterManagerオブジェクトを使用してヘッダーフッターを更新します。
- 最後に、Presentation.Save(string, SaveFormat)メソッドを使用してプレゼンテーションを保存します。
次のコードサンプルは、C#を使用してノートスライドのヘッダーとフッターを変更する方法を示しています。
// プレゼンテーションを読み込む
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// 最初のノートスライドのみのヘッダーとフッターの設定を変更する
INotesSlide notesSlide = presentation.Slides[0].NotesSlideManager.NotesSlide;
if (notesSlide != null)
{
INotesSlideHeaderFooterManager headerFooterManager = notesSlide.HeaderFooterManager;
if (!headerFooterManager.IsHeaderVisible)
headerFooterManager.SetHeaderVisibility(true); // make this notes slide Header placeholder visible
if (!headerFooterManager.IsFooterVisible)
headerFooterManager.SetFooterVisibility(true); // make this notes slide Footer placeholder visible
if (!headerFooterManager.IsSlideNumberVisible)
headerFooterManager.SetSlideNumberVisibility(true); // make this notes slide SlideNumber placeholder visible
if (!headerFooterManager.IsDateTimeVisible)
headerFooterManager.SetDateTimeVisibility(true); // make this notes slide Date-time placeholder visible
headerFooterManager.SetHeaderText("New header text"); // set text to notes slide Header placeholder
headerFooterManager.SetFooterText("New footer text"); // set text to notes slide Footer placeholder
headerFooterManager.SetDateTimeText("New date and time text"); // set text to notes slide Date-time placeholder
}
// プレゼンテーションを保存する
presentation.Save("testresult.pptx",SaveFormat.Pptx);
}
無料のAPIライセンスを取得する
評価の制限なしにAspose.Slides for .NETを使用するには、無料の一時ライセンスを入手してください。
結論
この記事では、C#を使用してPowerPointプレゼンテーションにヘッダーとフッターを追加する方法を学習しました。さらに、プログラムでノートスライドのヘッダーとフッターを変更する方法を見てきました。さらに、ドキュメントを調べて、Aspose.Slides for .NETの詳細を学ぶことができます。また、フォーラムから質問することもできます。