Hantera presentationens rubriker och sidfötter i Java

Vad den här sidan handlar om

Lär dig hur du hanterar sidfot-, datum‑tid‑, bildnummer‑ och rubrik‑platshållare på bilder, anteckningssidor och utdelningar med Aspose.Slides för Java.

Översikt

PowerPoint använder olika rubrik- och sidfotplatshållare beroende på sidtyp. Aspose.Slides for Java låter dig kontrollera texten och synligheten för dessa platshållare via rubrik-/sidfotshanterargränssnitt.

De tillgängliga platshållarna beror på omfånget:

Omfång	Rubrik	Sidfot	Datum/tid	Bild/ sidnummer
Vanlig bild	Nej	Ja	Ja	Ja
Antecknings‑master	Ja	Ja	Ja	Ja
Anteckningsbild	Ja	Ja	Ja	Ja
Utdelnings‑master	Ja	Ja	Ja	Ja

En vanlig presentationsbild har ingen rubrikplatshållare. Rubriker finns på anteckningssidor och utdelningar. För vanliga bilder, använd sidfot-, datum/tid- och bildnummer‑platshållare i stället.

Omfånget för en förändring beror på vilken hanterare du använder. Gränssnittet ISlideHeaderFooterManager kontrollerar en vanlig bild. Gränssnittet INotesSlideHeaderFooterManager kontrollerar en anteckningsbild. Master‑ och layout‑hanterare kan även sprida inställningar till beroende bilder, medan gränssnittet IMasterHandoutSlideHeaderFooterManager kontrollerar utdelnings‑mastern.

Ställ in sidfot, datum/tid och bildnummer på vanliga bilder

För vanliga bilder är det grundläggande arbetsflödet att komma åt varje bilds rubrik-/sidfotshanterare, sätta sidfot‑ och datum/tid‑text, aktivera de behövda platshållarna och spara presentationen. Bildnummer genereras av presentationen, så du behöver bara kontrollera deras synlighet.

Använd setFooterText och setDateTimeText för att sätta text, och använd setFooterVisibility, setDateTimeVisibility, och setSlideNumberVisibility för att visa de motsvarande platshållarna.

Följande end‑to‑end‑exempel tillämpar samma sidfot, datum/tid‑text och bildnummer‑synlighet på alla vanliga bilder:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideHeaderFooterManager headerFooterManager = slide.getHeaderFooterManager();

        headerFooterManager.setFooterText("Company Confidential");
        headerFooterManager.setFooterVisibility(true);

        headerFooterManager.setDateTimeText("Date and time text");
        headerFooterManager.setDateTimeVisibility(true);

        headerFooterManager.setSlideNumberVisibility(true);
    }

    presentation.save("presentation_with_slide_footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Om du bara behöver uppdatera en bild, kom åt den bilden direkt via metoden getSlides istället för att iterera genom hela samlingen.

Ställ in rubriker och sidfötter i antecknings‑master

Antecknings‑mastern definierar gemensam formatering och platshållarbeteende för anteckningssidor. Använd gränssnittet IMasterNotesSlideHeaderFooterManager när du vill ändra endast själva antecknings‑mastern.

Följande exempel sätter rubrik, sidfot och datum/tid‑text på antecknings‑mastern och gör alla stödda platshållare synliga i den mastern:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterNotesSlide masterNotesSlide = presentation.getMasterNotesSlideManager().getMasterNotesSlide();

    if (masterNotesSlide != null) {
        IMasterNotesSlideHeaderFooterManager headerFooterManager = masterNotesSlide.getHeaderFooterManager();

        headerFooterManager.setHeaderText("Notes header");
        headerFooterManager.setHeaderVisibility(true);

        headerFooterManager.setFooterText("Notes footer");
        headerFooterManager.setFooterVisibility(true);

        headerFooterManager.setDateTimeText("Date and time text");
        headerFooterManager.setDateTimeVisibility(true);

        headerFooterManager.setSlideNumberVisibility(true);
    }

    presentation.save("presentation_with_notes_master_footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Metoden getMasterNotesSlide returnerar null när presentationen inte innehåller en antecknings‑master.

Tillämpa antecknings‑masterinställningar på underordnade anteckningsbilder

En antecknings‑master kan applicera rubrik‑ och sidfotinställningar på sig själv och på alla beroende anteckningsbilder. Använd de dedikerade spridningsmetoderna på IMasterNotesSlideHeaderFooterManager när samma inställningar ska gälla i hela anteckningshierarkin.

Till exempel uppdaterar setHeaderAndChildHeadersText och setHeaderAndChildHeadersVisibility antecknings‑master‑rubriken och alla underordnade rubriker. Äquivalenta metoder finns för sidfötter, datum/tid och bildnummer.

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterNotesSlide masterNotesSlide = presentation.getMasterNotesSlideManager().getMasterNotesSlide();

    if (masterNotesSlide != null) {
        IMasterNotesSlideHeaderFooterManager headerFooterManager = masterNotesSlide.getHeaderFooterManager();

        headerFooterManager.setHeaderAndChildHeadersText("Notes header");
        headerFooterManager.setHeaderAndChildHeadersVisibility(true);

        headerFooterManager.setFooterAndChildFootersText("Notes footer");
        headerFooterManager.setFooterAndChildFootersVisibility(true);

        headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");
        headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);

        headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    }

    presentation.save("presentation_with_child_notes_footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Spridningsmetoderna som används ovan är setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility, och setSlideNumberAndChildSlideNumbersVisibility.

Ställ in rubriker och sidfötter på en enskild anteckningsbild

En anteckningsbild tillhör en specifik vanlig bild. Använd dess INotesSlideHeaderFooterManager när du vill anpassa endast den anteckningssidan.

Metoden addNotesSlide returnerar anteckningsbilden för den aktuella bilden och skapar en om den ännu inte finns. Följande exempel konfigurerar anteckningssidan som är kopplad till den första presentationsbilden:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    INotesSlide notesSlide = slide.getNotesSlideManager().addNotesSlide();
    INotesSlideHeaderFooterManager headerFooterManager = notesSlide.getHeaderFooterManager();

    headerFooterManager.setHeaderText("Header for the first notes page");
    headerFooterManager.setHeaderVisibility(true);

    headerFooterManager.setFooterText("Footer for the first notes page");
    headerFooterManager.setFooterVisibility(true);

    headerFooterManager.setDateTimeText("Date and time text");
    headerFooterManager.setDateTimeVisibility(true);

    headerFooterManager.setSlideNumberVisibility(true);

    presentation.save("presentation_with_custom_notes_footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Om du först sprider inställningar från antecknings‑mastern och sedan ändrar en enskild anteckningsbild, låter de senare per‑bild‑inställningarna dig anpassa den anteckningssidan oberoende.

Ställ in rubriker och sidfötter i utdelnings‑master

Utdelningssidor använder utdelnings‑mastern för sina rubrik‑, sidfot‑, datum/tid‑ och sidnummer‑platshållare. Till skillnad från anteckningssidor hanteras utdelningsinställningar via utdelnings‑mastern snarare än via enskilda utdelningsbilder.

Använd metoden getMasterHandoutSlide för att komma åt utdelnings‑mastern. Om den inte finns, anropa setDefaultMasterHandoutSlide för att skapa standard‑utdelnings‑mastern.

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterHandoutSlide masterHandoutSlide = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();

    if (masterHandoutSlide == null) {
        masterHandoutSlide = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();
    }

    if (masterHandoutSlide != null) {
        IMasterHandoutSlideHeaderFooterManager headerFooterManager = masterHandoutSlide.getHeaderFooterManager();

        headerFooterManager.setHeaderText("Handout header");
        headerFooterManager.setHeaderVisibility(true);

        headerFooterManager.setFooterText("Handout footer");
        headerFooterManager.setFooterVisibility(true);

        headerFooterManager.setDateTimeText("Date and time text");
        headerFooterManager.setDateTimeVisibility(true);

        headerFooterManager.setSlideNumberVisibility(true);
    }

    presentation.save("presentation_with_handout_footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Förstå omfång och arv

Välj den rubrik-/sidfotshanterare som motsvarar det omfång du vill ändra:

ISlideHeaderFooterManager ändrar sidfot-, datum/tid- och bildnummerinställningar för en vanlig bild.
ILayoutSlideHeaderFooterManager kontrollerar en layoutbild och kan sprida stödjade inställningar till beroende bilder.
IMasterSlideHeaderFooterManager kontrollerar en vanlig bildmaster och kan sprida stödjade inställningar till beroende bilder.
IMasterNotesSlideHeaderFooterManager kontrollerar antecknings‑master och kan sprida inställningar till alla beroende anteckningsbilder.
INotesSlideHeaderFooterManager ändrar en anteckningsbild och stödjer en rubrikplatshållare utöver sidfot, datum/tid och bildnummer.
IMasterHandoutSlideHeaderFooterManager ändrar utdelnings‑master och stödjer alla fyra platshållartyper.

Använd spridning från en master eller layout när samma inställning ska gälla genom hela hierarkin. Använd en individuell bild‑ eller antecknings‑bild‑hanterare när du behöver en lokal inställning för en sida.

Vanliga frågor

Kan jag lägga till en rubrik på en vanlig bild?

Nej. PowerPoint definierar ingen rubrikplatshållare för vanliga bilder. På vanliga bilder använder du sidfot-, datum/tid- och bildnummer‑platshållare. Rubrikplatshållare finns på anteckningssidor och utdelningar.

Vad händer om en sidfot-, datum/tid- eller bildnummer‑platshållare inte är synlig?

Använd den motsvarande rubrik-/sidfotshanteraren för att kontrollera dess synlighet och aktivera den vid behov. Till exempel rapporterar isFooterVisible om en sidfotplatshållare finns, och setFooterVisibility ändrar dess synlighet.

Hur startar jag bildnumrering från ett annat värde än 1?

Anropa presentationens metod setFirstSlideNumber. Bildnummer‑platshållarna använder då den uppdaterade numreringssekvensen.

Vad händer med rubriker och sidfötter vid export till PDF, bilder eller HTML?

Synliga rubrik‑ och sidfotelement renderas tillsammans med resten av presentationsinnehållet i den exporterade filen. Deras utseende beror på vilken sidtyp som exporteras och de respektive platshållarens synlighetsinställningar.

Mästra PowerPoint-teckensnitt i Java