Gérer les en-têtes et pieds de page de la présentation avec Python

Vue d’ensemble

Aspose.Slides for Python vous permet de contrôler les espaces réservés d’en-tête et de pied de page dans l’ensemble d’une présentation avec une portée précise. Le texte du pied de page, la date/heure et les numéros de diapositives sont gérés au niveau du masque et peuvent être appliqués globalement ou ajustés diapositives par diapositives. Les en-têtes sont pris en charge dans les notes et les prospectus, où vous pouvez basculer la visibilité et définir le texte de l’en‑tête, du pied de page, de la date/heure et des numéros de page via le gestionnaire dédié d’en‑tête et de pied de page du masque de notes ou des diapositives de notes individuelles. Cet article décrit les principaux modèles pour mettre à jour ces espaces réservés et propager les modifications de manière cohérente dans l’ensemble de votre présentation.

Gérer le texte d’en-tête et de pied de page

Dans cette section, vous apprendrez à gérer le contenu des en-têtes et pieds de page dans une présentation — activer ou modifier le pied de page, la date et l’heure, ainsi que les numéros de diapositives. Nous présenterons brièvement les portées d’application de ces paramètres (l’ensemble de la présentation, les diapositives individuelles et les vues notes/prospectus) et montrerons comment utiliser l’API Aspose.Slides pour les mettre à jour rapidement et de façon cohérente. L’exemple de code ci‑dessous ouvre une présentation, active et définit le texte du pied de page, met à jour le texte de l’en‑tête sur le masque de notes, puis enregistre le fichier.

import aspose.slides as slides

# Fonction pour définir le texte d'en-tête.
def update_header_footer_text(master):
    for shape in master.shapes:
        if shape.placeholder is not None:
            if shape.placeholder.type == slides.PlaceholderType.HEADER:
                shape.text_frame.text = "Hi, there is a header"


# Charger la présentation.
with slides.Presentation("sample.pptx") as presentation:
    # Définir le pied de page.
    presentation.header_footer_manager.set_all_footers_text("My Footer text")
    presentation.header_footer_manager.set_all_footers_visibility(True)

    # Accéder et mettre à jour l'en-tête.
    master_notes_slide = presentation.master_notes_slide_manager.master_notes_slide
    if master_notes_slide is not None:
        update_header_footer_text(master_notes_slide)

    # Enregistrer la présentation.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Gérer les en-têtes et pieds de page sur les diapositives de notes

Dans cette section, vous apprendrez à gérer les en-têtes et pieds de page spécifiquement pour les diapositives de notes dans Aspose.Slides. Nous aborderons l’activation des espaces réservés pertinents, la définition du texte pour les pieds de page, la date/heure et les numéros de page, ainsi que l’application cohérente de ces modifications sur le masque de notes et les pages de notes individuelles.
Suivez les étapes ci‑dessous :

Charger un fichier de présentation.
Obtenir la diapositive de notes maître et son gestionnaire d’en-tête et de pied de page.
Sur la diapositive de notes maître, activer la visibilité de l’En‑tête, du Pied de page, du Numéro de diapositive et de la Date‑heure pour le maître et toutes les diapositives de notes enfants.
Sur la diapositive de notes maître, définir le texte de l’En‑tête, du Pied de page et de la Date‑heure pour le maître et toutes les diapositives de notes enfants.
Obtenir la diapositive de notes de la première diapositive de la présentation et son gestionnaire d’en-tête et de pied de page.
Pour cette première diapositive de notes uniquement, s’assurer que l’En‑tête, le Pied de page, le Numéro de diapositive et la Date‑heure sont visibles (activer ceux qui sont désactivés).
Pour cette première diapositive de notes uniquement, définir le texte de l’En‑tête, du Pied de page et de la Date‑heure.
Enregistrer la présentation au format PPTX.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    master_notes_slide = presentation.master_notes_slide_manager.master_notes_slide
    if master_notes_slide is not None:
        header_footer_manager = master_notes_slide.header_footer_manager

        # Rendre la diapositive de notes maître et tous les espaces réservés d'en-tête, de pied de page, de numéro de diapositive et de date/heure enfants visibles.
        header_footer_manager.set_header_and_child_headers_visibility(True)
        header_footer_manager.set_footer_and_child_footers_visibility(True)
        header_footer_manager.set_slide_number_and_child_slide_numbers_visibility(True)
        header_footer_manager.set_date_time_and_child_date_times_visibility(True)

        # Définir le texte sur la diapositive de notes maître et tous les espaces réservés d'en-tête, de pied de page et de date/heure enfants.
        header_footer_manager.set_header_and_child_headers_text("Header text")
        header_footer_manager.set_footer_and_child_footers_text("Footer text")
        header_footer_manager.set_date_time_and_child_date_times_text("Date and time text")

    # Modifier les paramètres d'en-tête, de pied de page, de numéro de diapositive et de date/heure uniquement pour la première diapositive de notes.
    notesSlide = presentation.slides[0].notes_slide_manager.notes_slide
    if notesSlide is not None:
        header_footer_manager = notesSlide.header_footer_manager

        # S'assurer que les espaces réservés d'en-tête, de pied de page, de numéro de diapositive et de date/heure sont visibles.
        if not header_footer_manager.is_header_visible:
            header_footer_manager.set_header_visibility(True)

        if not header_footer_manager.is_footer_visible:
            header_footer_manager.set_footer_visibility(True)

        if not header_footer_manager.is_slide_number_visible:
            header_footer_manager.set_slide_number_visibility(True)

        if not header_footer_manager.is_date_time_visible:
            header_footer_manager.set_date_time_visibility(True)

        # Définir le texte sur les espaces réservés d'en-tête, de pied de page et de date/heure de la diapositive de notes.
        header_footer_manager.set_header_text("New header text")
        header_footer_manager.set_footer_text("New footer text")
        header_footer_manager.set_date_time_text("New date and time text")

    # Enregistrer la présentation.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

FAQ

Puis-je ajouter un “en‑tête” aux diapositives ordinaires ?
Dans PowerPoint, l’en‑tête n’existe que pour les notes et les prospectus ; sur les diapositives ordinaires, les éléments pris en charge sont le pied de page, la date/heure et le numéro de diapositive. Dans Aspose.Slides cela reflète les mêmes limitations : en‑tête uniquement pour les notes/prospectus, et sur les diapositives — Pied de page/DateHeure/NuméroDeDiapositive.

Et si la disposition ne contient pas de zone de pied de page—puis-je “activer” sa visibilité ?
Oui. Vérifiez la visibilité via le gestionnaire d’en‑tête et de pied de page et activez‑la si nécessaire. Ces indicateurs et méthodes de l’API sont conçus pour les cas où l’espace réservé est absent ou masqué.

Comment faire commencer le numéro de diapositive à une valeur autre que 1 ?
Définissez le premier numéro de diapositive de la présentation ; ensuite, toute la numérotation est recalculée. Par exemple, vous pouvez commencer à 0 ou 10, et masquer le numéro sur la diapositive de titre.

Que se passe-t‑il pour les en‑têtes/pieds de page lors de l’exportation en PDF/images/HTML ?
Ils sont rendus comme des éléments texte normaux de la présentation. Ainsi, si les éléments sont visibles sur les diapositives/pages de notes, ils apparaîtront également dans le format de sortie avec le reste du contenu.

Maîtriser les polices PowerPoint avec Python