Manage Presentation Headers and Footers in C++

Aspose.Slides provides support to work with slide’s headers and footers text that are actually maintained on Slide master level.

Aspose.Slides for C++ provides the feature for managing headers and footers inside presentation slides. These are in fact managed on the presentation master level.

Manage Header and Footer Text

Notes of some specific slide could be updated as shown in the example below:

// Function to set Header/Footer Text
void UpdateHeaderFooterText(System::SharedPtr<IBaseSlide> master)
{
    for (const auto& shape : System::IterateOver(master->get_Shapes()))
    {
        if (shape->get_Placeholder() != nullptr)
        {
            if (shape->get_Placeholder()->get_Type() == PlaceholderType::Header)
            {
                (System::ExplicitCast<IAutoShape>(shape))->get_TextFrame()->set_Text(u"HI there new header");
            }
        }
    }
}

// Load Presentation
auto pres = System::MakeObject<Presentation>(u"headerTest.pptx");

// Setting Footer
pres->get_HeaderFooterManager()->SetAllFootersText(u"My Footer text");
pres->get_HeaderFooterManager()->SetAllFootersVisibility(true);

// Access and Update Header
auto masterNotesSlide = pres->get_MasterNotesSlideManager()->get_MasterNotesSlide();
if (nullptr != masterNotesSlide)
{
	UpdateHeaderFooterText(masterNotesSlide);
}

// Save presentation
pres->Save(u"HeaderFooterJava.pptx", SaveFormat::Pptx);

Manage Headers and Footers on Handout and Notes Slides

Aspose.Slides for C++ supports Header and Footer in Handout and notes slides. Please follow the steps below:

Load a Presentation containing a video.
Change Header and Footer settings for notes master and all notes slides.
Set master notes slide and all child Footer placeholders visible.
Set master notes slide and all child Date and time placeholders visible.
Change Header and Footer settings for first notes slide only.
Set notes slide Header placeholder visible.
Set text to notes slide Header placeholder.
Set text to notes slide Date-time placeholder.
Write the modified presentation file.

Code Snippet provided in the below Example.

auto presentation = System::MakeObject<Presentation>(u"presentation.pptx");
// Change Header and Footer settings for notes master and all notes slides
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();
if (masterNotesSlide != nullptr)
{
	auto headerFooterManager = masterNotesSlide->get_HeaderFooterManager();

	// make the master notes slide and all child Footer placeholders visible
	headerFooterManager->SetHeaderAndChildHeadersVisibility(true);
	// make the master notes slide and all child Header placeholders visible
	headerFooterManager->SetFooterAndChildFootersVisibility(true);
	// make the master notes slide and all child SlideNumber placeholders visible
	headerFooterManager->SetSlideNumberAndChildSlideNumbersVisibility(true);
	// make the master notes slide and all child Date and time placeholders visible
	headerFooterManager->SetDateTimeAndChildDateTimesVisibility(true);

	// set text to master notes slide and all child Header placeholders
	headerFooterManager->SetHeaderAndChildHeadersText(u"Header text");
	// set text to master notes slide and all child Footer placeholders
	headerFooterManager->SetFooterAndChildFootersText(u"Footer text");
	// set text to master notes slide and all child Date and time placeholders
	headerFooterManager->SetDateTimeAndChildDateTimesText(u"Date and time text");
}

// Change Header and Footer settings for first notes slide only
auto notesSlide = presentation->get_Slides()->idx_get(0)->get_NotesSlideManager()->get_NotesSlide();
if (notesSlide != nullptr)
{
	auto headerFooterManager = notesSlide->get_HeaderFooterManager();
	if (!headerFooterManager->get_IsHeaderVisible())
	{
		// make this notes slide Header placeholder visible
		headerFooterManager->SetHeaderVisibility(true);
	}

	if (!headerFooterManager->get_IsFooterVisible())
	{
		// make this notes slide Footer placeholder visible
		headerFooterManager->SetFooterVisibility(true);
	}

	if (!headerFooterManager->get_IsSlideNumberVisible())
	{
		// make this notes slide SlideNumber placeholder visible
		headerFooterManager->SetSlideNumberVisibility(true);
	}
	
	if (!headerFooterManager->get_IsDateTimeVisible())
	{
		// make this notes slide Date-time placeholder visible
		headerFooterManager->SetDateTimeVisibility(true);
	}
	
	// set text to notes slide Header placeholder
	headerFooterManager->SetHeaderText(u"New header text");
	// set text to notes slide Footer placeholder
	headerFooterManager->SetFooterText(u"New footer text");
	// set text to notes slide Date-time placeholder
	headerFooterManager->SetDateTimeText(u"New date and time text");
}

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

FAQ

Can I add a “header” to regular slides?

In PowerPoint, “Header” exists only for notes and handouts; on regular slides, the supported elements are the footer, date/time, and slide number. In Aspose.Slides this matches the same limitations: header only for Notes/Handout, and on slides—Footer/DateTime/SlideNumber.

What if the layout doesn’t contain a footer area—can I “turn on” its visibility?

Yes. Check the visibility via the header/footer manager and enable it if needed. These API indicators and methods are designed for cases when the placeholder is missing or hidden.

How do I make the slide number start from a value other than 1?

Set the presentation’s first slide number; after that, all numbering is recalculated. For example, you can start at 0 or 10, and hide the number on the title slide.

What happens to headers/footers when exporting to PDF/images/HTML?

They are rendered as regular text elements of the presentation. That is, if the elements are visible on slides/notes pages, they will also appear in the output format along with the rest of the content.

Master PowerPoint Fonts in C++