Gestire intestazioni e piè di pagina della presentazione in Python via Java

Di cosa tratta questa pagina

Scopri come gestire i segnaposti di piè di pagina, data/ora, numero diapositiva e intestazione su diapositive, pagine note e opuscoli con Aspose.Slides per Python via Java.

Panoramica

PowerPoint utilizza segnaposti di intestazione e piè di pagina diversi a seconda del tipo di pagina. Aspose.Slides for Python via Java consente di controllare il testo e la visibilità di questi segnaposti tramite le classi manager di intestazione/piè di pagina.

I segnaposti disponibili dipendono dall’ambito:

Ambito	Intestazione	Piè di pagina	Data/ora	Numero diapositiva/pagina
Diapositiva regolare	No	Sì	Sì	Sì
Schema note	Sì	Sì	Sì	Sì
Diapositiva note	Sì	Sì	Sì	Sì
Schema opuscolo	Sì	Sì	Sì	Sì

Una diapositiva regolare non ha un segnaposto di intestazione. Le intestazioni sono disponibili nelle pagine note e negli opuscoli. Per le diapositive regolari, utilizzare i segnaposti di piè di pagina, data/ora e numero diapositiva.

L’ambito di una modifica dipende dal manager utilizzato. La classe SlideHeaderFooterManager controlla una singola diapositiva regolare. La classe NotesSlideHeaderFooterManager controlla una singola diapositiva note. I manager di schema e layout possono anche propagare le impostazioni alle diapositive dipendenti, mentre la classe MasterHandoutSlideHeaderFooterManager controlla lo schema opuscolo.

Imposta piè di pagina, data/ora e numeri di diapositiva sulle diapositive regolari

Per le diapositive regolari, il flusso di lavoro base è accedere al manager di intestazione/piè di pagina di ciascuna diapositiva, impostare il testo del piè di pagina e della data/ora, abilitare i segnaposti richiesti e salvare la presentazione. I numeri di diapositiva sono generati dalla presentazione, quindi è necessario controllarne solo la visibilità.

Usa setFooterText e setDateTimeText per impostare il testo, e utilizza setFooterVisibility, setDateTimeVisibility e setSlideNumberVisibility per mostrare i corrispondenti segnaposti.

Il seguente esempio end‑to‑end applica lo stesso piè di pagina, testo data/ora e visibilità del numero di diapositiva a tutte le diapositive regolari:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    for slide in presentation.getSlides():
        header_footer_manager = slide.getHeaderFooterManager()

        header_footer_manager.setFooterText("Company Confidential")
        header_footer_manager.setFooterVisibility(True)

        header_footer_manager.setDateTimeText("Date and time text")
        header_footer_manager.setDateTimeVisibility(True)

        header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_slide_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Se è necessario aggiornare una sola diapositiva, accedi direttamente a quella diapositiva tramite il metodo getSlides anziché iterare sull’intera collezione.

Imposta intestazioni e piè di pagina sullo schema note

Lo schema note definisce la formattazione comune e il comportamento dei segnaposti per le pagine note. Usa la classe MasterNotesSlideHeaderFooterManager quando vuoi modificare solo lo schema note stesso.

Il seguente esempio imposta intestazione, piè di pagina e testo data/ora sullo schema note e rende tutti i segnaposti supportati visibili su quello schema:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    master_notes_slide = presentation.getMasterNotesSlideManager().getMasterNotesSlide()

    if master_notes_slide is not None:
        header_footer_manager = master_notes_slide.getHeaderFooterManager()

        header_footer_manager.setHeaderText("Notes header")
        header_footer_manager.setHeaderVisibility(True)

        header_footer_manager.setFooterText("Notes footer")
        header_footer_manager.setFooterVisibility(True)

        header_footer_manager.setDateTimeText("Date and time text")
        header_footer_manager.setDateTimeVisibility(True)

        header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_notes_master_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Il metodo getMasterNotesSlide restituisce None quando la presentazione non contiene uno schema note.

Applica le impostazioni dello schema note alle diapositive note figlie

Uno schema note può applicare le impostazioni di intestazione e piè di pagina a sé stesso e a tutte le diapositive note dipendenti. Usa i metodi di propagazione dedicati su MasterNotesSlideHeaderFooterManager quando le stesse impostazioni devono essere applicate all’intera gerarchia delle note.

Ad esempio, setHeaderAndChildHeadersText e setHeaderAndChildHeadersVisibility aggiornano l’intestazione dello schema note e tutte le intestazioni figlie. Metodi equivalenti sono disponibili per i piè di pagina, data/ora e numeri di diapositiva.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    master_notes_slide = presentation.getMasterNotesSlideManager().getMasterNotesSlide()

    if master_notes_slide is not None:
        header_footer_manager = master_notes_slide.getHeaderFooterManager()

        header_footer_manager.setHeaderAndChildHeadersText("Notes header")
        header_footer_manager.setHeaderAndChildHeadersVisibility(True)

        header_footer_manager.setFooterAndChildFootersText("Notes footer")
        header_footer_manager.setFooterAndChildFootersVisibility(True)

        header_footer_manager.setDateTimeAndChildDateTimesText("Date and time text")
        header_footer_manager.setDateTimeAndChildDateTimesVisibility(True)

        header_footer_manager.setSlideNumberAndChildSlideNumbersVisibility(True)

    presentation.save("presentation_with_child_notes_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

I metodi di propagazione usati sopra sono setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility e setSlideNumberAndChildSlideNumbersVisibility.

Imposta intestazioni e piè di pagina su una singola diapositiva note

Una diapositiva note appartiene a una specifica diapositiva regolare. Usa la sua classe NotesSlideHeaderFooterManager quando vuoi personalizzare solo quella pagina note.

Il metodo addNotesSlide restituisce la diapositiva note per la diapositiva corrente e ne crea una se non esiste già. Il seguente esempio configura la pagina note associata alla prima diapositiva della presentazione:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    notes_slide = slide.getNotesSlideManager().addNotesSlide()
    header_footer_manager = notes_slide.getHeaderFooterManager()

    header_footer_manager.setHeaderText("Header for the first notes page")
    header_footer_manager.setHeaderVisibility(True)

    header_footer_manager.setFooterText("Footer for the first notes page")
    header_footer_manager.setFooterVisibility(True)

    header_footer_manager.setDateTimeText("Date and time text")
    header_footer_manager.setDateTimeVisibility(True)

    header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_custom_notes_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Se prima propaghi le impostazioni dallo schema note e poi modifichi una diapositiva note individuale, le impostazioni successive per diapositiva consentono di personalizzare quella pagina note in modo indipendente.

Imposta intestazioni e piè di pagina sullo schema opuscolo

Le pagine opuscolo usano lo schema opuscolo per i loro segnaposti di intestazione, piè di pagina, data/ora e numero pagina. A differenza delle pagine note, le impostazioni degli opuscoli sono gestite tramite lo schema opuscolo anziché tramite singole diapositive opuscolo.

Usa il metodo getMasterHandoutSlide per accedere allo schema opuscolo. Se non è presente, chiama setDefaultMasterHandoutSlide per creare lo schema opuscolo predefinito.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    master_handout_slide = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide()

    if master_handout_slide is None:
        master_handout_slide = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide()

    if master_handout_slide is not None:
        header_footer_manager = master_handout_slide.getHeaderFooterManager()

        header_footer_manager.setHeaderText("Handout header")
        header_footer_manager.setHeaderVisibility(True)

        header_footer_manager.setFooterText("Handout footer")
        header_footer_manager.setFooterVisibility(True)

        header_footer_manager.setDateTimeText("Date and time text")
        header_footer_manager.setDateTimeVisibility(True)

        header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_handout_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Comprendi ambito ed ereditarietà

Scegli il manager di intestazione/piè di pagina che corrisponde all’ambito che desideri modificare:

• SlideHeaderFooterManager modifica le impostazioni di piè di pagina, data/ora e numero diapositiva per una singola diapositiva regolare.
• LayoutSlideHeaderFooterManager controlla una diapositiva layout e può propagare le impostazioni supportate alle diapositive dipendenti.
• MasterSlideHeaderFooterManager controlla uno schema diapositiva regolare e può propagare le impostazioni supportate alle diapositive dipendenti.
• MasterNotesSlideHeaderFooterManager controlla lo schema note e può propagare le impostazioni a tutte le diapositive note dipendenti.
• NotesSlideHeaderFooterManager modifica una singola diapositiva note e supporta un segnaposto di intestazione oltre a piè di pagina, data/ora e numero diapositiva.
• MasterHandoutSlideHeaderFooterManager modifica lo schema opuscolo e supporta tutti e quattro i tipi di segnaposto.

Usa la propagazione da uno schema o layout quando la stessa impostazione deve applicarsi a tutta la gerarchia. Usa un manager di diapositiva individuale o di diapositiva note quando hai bisogno di un’impostazione locale per una sola pagina.

FAQ

Posso aggiungere un’intestazione a una diapositiva regolare?

No. PowerPoint non definisce un segnaposto di intestazione per le diapositive regolari. Su diapositive regolari, usa i segnaposti di piè di pagina, data/ora e numero diapositiva. I segnaposti di intestazione sono disponibili nelle pagine note e negli opuscoli.

Cosa succede se un segnaposto di piè di pagina, data/ora o numero diapositiva non è visibile?

Usa il manager di intestazione/piè di pagina corrispondente per verificare la sua visibilità e abilitarlo quando necessario. Per esempio, isFooterVisible indica se è presente un segnaposto di piè di pagina, e setFooterVisibility ne modifica la visibilità.

Come faccio a far partire la numerazione delle diapositive da un valore diverso da 1?

Chiama il metodo setFirstSlideNumber della presentazione. I segnaposti di numero diapositiva utilizzeranno la sequenza di numerazione aggiornata.

Cosa succede a intestazioni e piè di pagina quando si esporta in PDF, immagini o HTML?

Gli elementi di intestazione e piè di pagina visibili vengono renderizzati insieme al resto del contenuto della presentazione nel formato di output. La loro apparenza dipende dal tipo di pagina esportata e dalle impostazioni di visibilità dei segnaposti corrispondenti.