Beheer presentatiekopt- en voetteksten in JavaScript

Waar deze pagina over gaat

Leer hoe u koptekst-, voettekst-, datum-tijd- en dia-nummer-plaatsaanduidingen op dia’s, notitiepagina’s en handouts kunt beheren met Aspose.Slides voor Node.js via Java.

Overzicht

PowerPoint gebruikt verschillende kop‑ en voettekst‑plaatsaanduidingen afhankelijk van het paginatype. Aspose.Slides voor Node.js via Java stelt u in staat de tekst en zichtbaarheid van deze plaatsaanduidingen te beheersen via kop‑/voettekst‑managerklassen.

De beschikbare plaatsaanduidingen hangen af van de reikwijdte:

Bereik	Koptekst	Voettekst	Datum/tijd	Dia-/paginanummer
Reguliere dia	Nee	Ja	Ja	Ja
Notitie‑master	Ja	Ja	Ja	Ja
Notitiedia	Ja	Ja	Ja	Ja
Handout‑master	Ja	Ja	Ja	Ja

Een regulier presentatiedia heeft geen koptekst‑plaatsaanduiding. Kopteksten zijn beschikbaar op notitiepagina’s en handouts. Voor reguliere dia’s gebruikt u in plaats daarvan de voettekst‑, datum/tijd‑ en dia‑nummer‑plaatsaanduidingen.

De reikwijdte van een wijziging hangt af van de manager die u gebruikt. De SlideHeaderFooterManager klasse stuurt één regulier dia aan. De NotesSlideHeaderFooterManager klasse stuurt één notitiedia aan. Master‑ en layout‑managers kunnen de instellingen ook doorvoeren naar afhankelijke dia’s, terwijl de MasterHandoutSlideHeaderFooterManager klasse de handout‑master beheert.

Voettekst, datum/tijd en dia‑nummers instellen op reguliere dia’s

Voor reguliere dia’s bestaat de basisworkflow uit het benaderen van de kop‑/voettekst‑manager van elke dia, het instellen van de voettekst‑ en datum/tijd‑tekst, het inschakelen van de benodigde plaatsaanduidingen, en het opslaan van de presentatie. Dia‑nummers worden door de presentatie gegenereerd, dus u hoeft alleen hun zichtbaarheid te regelen.

Gebruik setFooterText en setDateTimeText om tekst in te stellen, en gebruik setFooterVisibility, setDateTimeVisibility en setSlideNumberVisibility om de overeenkomstige plaatsaanduidingen weer te geven.

Het volgende end‑to‑end‑voorbeeld past dezelfde voettekst, datum/tijd‑tekst en dia‑nummer‑zichtbaarheid toe op alle reguliere dia’s:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    for (let i = 0; i < presentation.getSlides().size(); i++) {
        const slide = presentation.getSlides().get_Item(i);
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Als u slechts één dia wilt bijwerken, benader dan die dia rechtstreeks via de getSlides‑methode in plaats van door de volledige collectie te itereren.

Kop‑ en voetteksten instellen op de notitie‑master

De notitie‑master bepaalt gemeenschappelijke opmaak en plaatsaanduidingsgedrag voor notitiepagina’s. Gebruik de MasterNotesSlideHeaderFooterManager klasse wanneer u alleen de notitie‑master zelf wilt wijzigen.

Het volgende voorbeeld stelt koptekst, voettekst en datum/tijd‑tekst in op de notitie‑master en maakt alle ondersteunde plaatsaanduidingen zichtbaar op die master:

const slides = require("aspose.slides.via.java");

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

    if (masterNotesSlide !== null) {
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

De getMasterNotesSlide methode retourneert null wanneer de presentatie geen notitie‑master bevat.

Instellingen van de notitie‑master toepassen op onderliggende notitiedia’s

Een notitie‑master kan de kop‑ en voettekstinstellingen toepassen op zichzelf en op alle afhankelijke notitiedia’s. Gebruik de speciale propagatiemethoden op de MasterNotesSlideHeaderFooterManager wanneer dezelfde instellingen over de hele notitie‑hiërarchie moeten worden toegepast.

Bijvoorbeeld, setHeaderAndChildHeadersText en setHeaderAndChildHeadersVisibility werken de notitie‑master‑koptekst en alle onderliggende kopteksten bij. Gelijkwaardige methoden zijn beschikbaar voor voetteksten, datum/tijd en dia‑nummers.

const slides = require("aspose.slides.via.java");

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

    if (masterNotesSlide !== null) {
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

De propagatiemethoden die hierboven werden gebruikt, zijn setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility en setSlideNumberAndChildSlideNumbersVisibility.

Kop‑ en voetteksten instellen op een individuele notitiedia

Een notitiedia behoort tot een specifieke reguliere dia. Gebruik de NotesSlideHeaderFooterManager klasse wanneer u alleen die notitiepagina wilt aanpassen.

De addNotesSlide methode retourneert de notitiedia voor de huidige dia en maakt er een aan als deze nog niet bestaat. Het volgende voorbeeld configureert de notitiepagina die bij de eerste presentatiedia hoort:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const headerFooterManager = slide.getNotesSlideManager().addNotesSlide().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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Als u eerst instellingen van de notitie‑master doorvoert en daarna een individuele notitiedia wijzigt, laten de latere per‑dia‑instellingen u die notitiepagina onafhankelijk aanpassen.

Kop‑ en voetteksten instellen op de handout‑master

Handout‑pagina’s gebruiken de handout‑master voor hun kop‑, voettekst‑, datum/tijd‑ en paginanummer‑plaatsaanduidingen. In tegenstelling tot notitiepagina’s worden handout‑instellingen beheerd via de handout‑master in plaats van via individuele handout‑dia’s.

Gebruik getMasterHandoutSlide om de handout‑master te benaderen. Als deze niet aanwezig is, roep dan setDefaultMasterHandoutSlide aan om de standaard handout‑master te creëren.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    let masterHandoutSlide = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();

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

    if (masterHandoutSlide !== null) {
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Begrijp reikwijdte en overerving

Kies de kop‑/voettekst‑manager die overeenkomt met de reikwijdte die u wilt wijzigen:

SlideHeaderFooterManager wijzigt voettekst-, datum/tijd- en dia‑nummerinstellingen voor één reguliere dia.
LayoutSlideHeaderFooterManager beheert een layout‑dia en kan ondersteunde instellingen doorvoeren naar afhankelijke dia’s.
MasterSlideHeaderFooterManager beheert een reguliere dia‑master en kan ondersteunde instellingen doorvoeren naar afhankelijke dia’s.
MasterNotesSlideHeaderFooterManager beheert de notitie‑master en kan instellingen doorvoeren naar alle afhankelijke notitiedia’s.
NotesSlideHeaderFooterManager wijzigt één notitiedia en ondersteunt een koptekst‑plaatsaanduiding naast voettekst, datum/tijd en dia‑nummer.
MasterHandoutSlideHeaderFooterManager wijzigt de handout‑master en ondersteunt alle vier de plaatsaanduidingstypen.

Gebruik propagatie vanaf een master of layout wanneer dezelfde instelling door de hele hiërarchie moet gelden. Gebruik een individuele dia‑ of notitiedia‑manager wanneer u een lokale instelling voor één pagina nodig heeft.

FAQ

Kan ik een koptekst toevoegen aan een regulier dia?

Nee. PowerPoint definieert geen koptekst‑plaatsaanduiding voor reguliere dia’s. Op reguliere dia’s gebruikt u de voettekst‑, datum/tijd‑ en dia‑nummer‑plaatsaanduidingen. Koptekst‑plaatsaanduidingen zijn beschikbaar op notitiepagina’s en handouts.

Wat als een voettekst‑, datum/tijd‑ of dia‑nummer‑plaatsaanduiding niet zichtbaar is?

Gebruik de overeenkomstige kop‑/voettekst‑manager om de zichtbaarheid te controleren en deze in te schakelen wanneer nodig. Bijvoorbeeld, isFooterVisible meldt of een voettekst‑plaatsaanduiding aanwezig is, en setFooterVisibility wijzigt de zichtbaarheid.

Hoe start ik de dia‑nummering vanaf een andere waarde dan 1?

Roep de setFirstSlideNumber‑methode van de presentatie aan. De dia‑nummer‑plaatsaanduidingen gebruiken vervolgens de bijgewerkte nummeringsreeks.

Wat gebeurt er met kop‑ en voetteksten bij het exporteren naar PDF, afbeeldingen of HTML?

Zichtbare kop‑ en voettekstelementen worden samen met de rest van de presentatiewaarde gerenderd in het uitvoerformaat. Hun weergave hangt af van het paginatype dat wordt geëxporteerd en de bijbehorende plaatsaanduiding‑zichtbaarheidsinstellingen.

Beheers PowerPoint-lettertypen in JavaScript