Gérer les en-têtes et pieds de page des présentations sur Android

À propos de cette page

Apprenez comment gérer les espaces réservés de pied de page, de date-heure, de numéro de diapositive et d’en-tête sur les diapositives, les pages de notes et les prospectus avec Aspose.Slides pour Android via Java.

Vue d’ensemble

PowerPoint utilise différents espaces réservés d’en‑tête et de pied de page en fonction du type de page. Aspose.Slides for Android via Java vous permet de contrôler le texte et la visibilité de ces espaces réservés via les interfaces de gestion des en‑têtes/pieds de page.

Les espaces réservés disponibles dépendent de la portée :

Portée	En‑tête	Pied de page	Date/heure	Numéro de diapositive/page
Diapositive normale	Non	Oui	Oui	Oui
Masque de notes	Oui	Oui	Oui	Oui
Diapositive de notes	Oui	Oui	Oui	Oui
Masque de prospectus	Oui	Oui	Oui	Oui

Une diapositive de présentation normale ne possède pas d’espace réservé d’en‑tête. Les en‑têtes sont disponibles sur les pages de notes et les prospectus. Pour les diapositives normales, utilisez plutôt les espaces réservés de pied de page, de date/heure et de numéro de diapositive.

La portée d’une modification dépend du gestionnaire que vous utilisez. L’interface ISlideHeaderFooterManager contrôle une diapositive normale. L’interface INotesSlideHeaderFooterManager contrôle une diapositive de notes. Les gestionnaires de masques et de mise en page peuvent également propager les paramètres aux diapositives dépendantes, tandis que l’interface IMasterHandoutSlideHeaderFooterManager contrôle le masque de prospectus.

Définir le pied de page, la date/heure et les numéros de diapositive sur les diapositives normales

Pour les diapositives normales, le flux de travail de base consiste à accéder au gestionnaire d’en‑tête/pied de page de chaque diapositive, définir le texte du pied de page et de la date/heure, activer les espaces réservés requis, puis enregistrer la présentation. Les numéros de diapositive sont générés par la présentation, vous n’avez donc besoin que de contrôler leur visibilité.

Utilisez setFooterText et setDateTimeText pour définir le texte, et utilisez setFooterVisibility, setDateTimeVisibility, et setSlideNumberVisibility pour afficher les espaces réservés correspondants.

L’exemple complet suivant applique le même pied de page, le même texte de date/heure et la même visibilité du numéro de diapositive à toutes les diapositives normales :

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();
}

Si vous devez mettre à jour une seule diapositive, accédez directement à cette diapositive via la méthode getSlides au lieu d’itérer sur l’ensemble de la collection.

Définir les en‑têtes et pieds de page sur le masque de notes

Le masque de notes définit le formatage commun et le comportement des espaces réservés pour les pages de notes. Utilisez l’interface IMasterNotesSlideHeaderFooterManager lorsque vous souhaitez modifier uniquement le masque de notes lui‑-même.

L’exemple suivant définit le texte de l’en‑tête, du pied de page et de la date/heure sur le masque de notes et rend visibles tous les espaces réservés pris en charge sur ce masque :

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();
}

La méthode getMasterNotesSlide renvoie null lorsqu’une présentation ne contient pas de masque de notes.

Appliquer les paramètres du masque de notes aux diapositives de notes enfants

Un masque de notes peut appliquer les paramètres d’en‑tête et de pied de page à lui‑même et à toutes les diapositives de notes dépendantes. Utilisez les méthodes de propagation dédiées sur IMasterNotesSlideHeaderFooterManager lorsque les mêmes paramètres doivent être appliqués à l’ensemble de la hiérarchie de notes.

Par exemple, setHeaderAndChildHeadersText et setHeaderAndChildHeadersVisibility mettent à jour l’en‑tête du masque de notes et tous les en‑têtes enfants. Des méthodes équivalentes sont disponibles pour les pieds de page, la date/heure et les numéros de diapositive.

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();
}

Les méthodes de propagation utilisées ci‑dessus sont setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility, et setSlideNumberAndChildSlideNumbersVisibility.

Définir les en‑têtes et pieds de page sur une diapositive de notes individuelle

Une diapositive de notes appartient à une diapositive normale spécifique. Utilisez son interface INotesSlideHeaderFooterManager lorsque vous souhaitez personnaliser uniquement cette page de notes.

La méthode addNotesSlide renvoie la diapositive de notes pour la diapositive actuelle et en crée une si elle n’existe pas déjà. L’exemple suivant configure la page de notes associée à la première diapositive de la présentation :

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();
}

Si vous propaguez d’abord les paramètres du masque de notes, puis modifiez une diapositive de notes individuelle, les paramètres ultérieurs par diapositive vous permettent de personnaliser cette page de notes de façon indépendante.

Définir les en‑têtes et pieds de page sur le masque de prospectus

Les pages de prospectus utilisent le masque de prospectus pour leurs espaces réservés d’en‑tête, de pied de page, de date/heure et de numéro de page. Contrairement aux pages de notes, les paramètres du prospectus sont gérés via le masque de prospectus plutôt que via des diapositives de prospectus individuelles.

Utilisez la méthode getMasterHandoutSlide pour accéder au masque de prospectus. S’il n’est pas présent, appelez setDefaultMasterHandoutSlide pour créer le masque de prospectus par défaut.

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();
}

Comprendre la portée et l’héritage

Choisissez le gestionnaire d’en‑tête/pied de page correspondant à la portée que vous souhaitez modifier :

ISlideHeaderFooterManager modifie les paramètres de pied de page, de date/heure et de numéro de diapositive pour une seule diapositive normale.
ILayoutSlideHeaderFooterManager contrôle une diapositive de mise en page et peut propager les paramètres pris en charge aux diapositives dépendantes.
IMasterSlideHeaderFooterManager contrôle un masque de diapositive normal et peut propager les paramètres pris en charge aux diapositives dépendantes.
IMasterNotesSlideHeaderFooterManager contrôle le masque de notes et peut propager les paramètres à toutes les diapositives de notes dépendantes.
INotesSlideHeaderFooterManager modifie une diapositive de notes et prend en charge un espace réservé d’en‑tête en plus du pied de page, de la date/heure et du numéro de diapositive.
IMasterHandoutSlideHeaderFooterManager modifie le masque de prospectus et prend en charge les quatre types d’espaces réservés.

Utilisez la propagation depuis un masque ou une mise en page lorsque le même paramètre doit s’appliquer à toute sa hiérarchie. Utilisez un gestionnaire de diapositive individuelle ou de diapositive de notes lorsque vous avez besoin d’un paramètre local pour une seule page.

FAQ

Puis-je ajouter un en‑tête à une diapositive normale ?

Non. PowerPoint ne définit pas d’espace réservé d’en‑tête pour les diapositives normales. Sur les diapositives normales, utilisez les espaces réservés de pied de page, de date/heure et de numéro de diapositive. Les espaces réservés d’en‑tête sont disponibles sur les pages de notes et les prospectus.

Que faire si un espace réservé de pied de page, de date/heure ou de numéro de diapositive n’est pas visible ?

Utilisez le gestionnaire d’en‑tête/pied de page correspondant pour vérifier sa visibilité et l’activer si nécessaire. Par exemple, isFooterVisible indique si un espace réservé de pied de page est présent, et setFooterVisibility modifie sa visibilité.

Comment démarrer la numérotation des diapositives à partir d’une valeur autre que 1 ?

Appelez la méthode setFirstSlideNumber de la présentation. Les espaces réservés de numéro de diapositive utiliseront alors la séquence de numérotation mise à jour.

Que se passe-t-il avec les en‑têtes et pieds de page lors de l’exportation en PDF, images ou HTML ?

Les éléments d’en‑tête et de pied de page visibles sont rendus avec le reste du contenu de la présentation dans le format de sortie. Leur apparence dépend du type de page exporté et des paramètres de visibilité des espaces réservés correspondants.

Polices PowerPoint