Appliquer ou modifier une mise en page de diapositive en C#

Vue d’ensemble

Une disposition de diapositive définit l’agencement des zones réservées et le formatage du contenu d’une diapositive. Elle contrôle quelles zones réservées sont disponibles et où elles apparaissent. Les dispositions de diapositives vous aident à créer des présentations rapidement et de façon cohérente—qu’il s’agisse de quelque chose de simple ou de plus complexe. Parmi les dispositions de diapositives les plus courantes dans PowerPoint :

Disposition de diapositive Titre – Comprend deux zones réservées : une pour le titre et une pour le sous‑titre.

Disposition Titre et Contenu – Propose une petite zone réservée de titre en haut et une plus grande en dessous pour le contenu principal (texte, puces, graphiques, images, etc.).

Disposition Vide – Ne contient aucune zone réservée, vous donnant un contrôle total pour concevoir la diapositive à partir de zéro.

Les dispositions de diapositives font partie d’un masque de diapositive, qui est la diapositive de niveau supérieur définissant les styles de disposition pour la présentation. Vous pouvez accéder aux dispositions et les modifier via le masque de diapositives—par leur type, leur nom ou leur ID unique. Vous pouvez également éditer une disposition spécifique directement dans la présentation.

Pour travailler avec les dispositions de diapositives dans Aspose.Slides for .NET, vous pouvez utiliser :

Des propriétés telles que LayoutSlides et Masters sous la classe Presentation
Des types comme ILayoutSlide, IMasterLayoutSlideCollection, ILayoutPlaceholderManager et ILayoutSlideHeaderFooterManager

Info

Pour en savoir plus sur la gestion des masques de diapositives, consultez l’article Slide Master.

Ajouter des dispositions de diapositive aux présentations

Pour personnaliser l’apparence et la structure de vos diapositives, il peut être nécessaire d’ajouter de nouvelles dispositions à une présentation. Aspose.Slides for .NET vous permet de vérifier si une disposition donnée existe déjà, d’en ajouter une nouvelle si besoin, puis d’insérer des diapositives basées sur cette disposition.

Créez une instance de la classe Presentation.
Accédez à la IMasterLayoutSlideCollection.
Vérifiez si la disposition souhaitée existe déjà dans la collection. Si ce n’est pas le cas, ajoutez la disposition requise.
Ajoutez une diapositive vide basée sur la nouvelle disposition.
Enregistrez la présentation.

Le code C# suivant montre comment ajouter une disposition de diapositive à une présentation PowerPoint :

// Instancier la classe Presentation qui représente un fichier PowerPoint.
using (Presentation presentation = new Presentation("Sample.pptx"))
{
    // Parcourir les types de diapositives de mise en page pour sélectionner une mise en page.
    IMasterLayoutSlideCollection layoutSlides = presentation.Masters[0].LayoutSlides;
    ILayoutSlide layoutSlide = layoutSlides.GetByType(SlideLayoutType.TitleAndObject) ?? layoutSlides.GetByType(SlideLayoutType.Title);

    if (layoutSlide == null)
    {
        // Situation où la présentation ne contient pas tous les types de mise en page.
        // Le fichier de présentation ne contient que les types de mise en page Blank et Custom.
        // Cependant, les diapositives de mise en page avec des types personnalisés peuvent avoir des noms reconnaissables,
        // comme "Title", "Title and Content", etc., qui peuvent être utilisés pour la sélection de la diapositive de mise en page.
        // Vous pouvez également vous appuyer sur un ensemble de types de formes d'espace réservé.
        // Par exemple, une diapositive Title ne doit contenir que le type d'espace réservé Title, etc.
        foreach (ILayoutSlide titleAndObjectLayoutSlide in layoutSlides)
        {
            if (titleAndObjectLayoutSlide.Name == "Title and Object")
            {
                layoutSlide = titleAndObjectLayoutSlide;
                break;
            }
        }

        if (layoutSlide == null)
        {
            foreach (ILayoutSlide titleLayoutSlide in layoutSlides)
            {
                if (titleLayoutSlide.Name == "Title")
                {
                    layoutSlide = titleLayoutSlide;
                    break;
                }
            }

            if (layoutSlide == null)
            {
                layoutSlide = layoutSlides.GetByType(SlideLayoutType.Blank);
                if (layoutSlide == null)
                {
                    layoutSlide = layoutSlides.Add(SlideLayoutType.TitleAndObject, "Title and Object");
                }
            }
        }
    }

    // Ajouter une diapositive vide en utilisant la mise en page ajoutée.
    presentation.Slides.InsertEmptySlide(0, layoutSlide);

    // Enregistrer la présentation sur le disque.  
    presentation.Save("Output.pptx", SaveFormat.Pptx);
}

Supprimer les dispositions de diapositive inutilisées

Aspose.Slides fournit la méthode RemoveUnusedLayoutSlides de la classe Compress pour vous permettre de supprimer les dispositions de diapositive indésirables et non utilisées.

Le code C# suivant montre comment supprimer une disposition de diapositive d’une présentation PowerPoint :

using (Presentation presentation = new Presentation("Presentation.pptx"))
{
    Aspose.Slides.LowCode.Compress.RemoveUnusedLayoutSlides(presentation);
    
    presentation.Save("Output.pptx", SaveFormat.Pptx);
}

Ajouter des zones réservées aux dispositions de diapositive

Aspose.Slides fournit la propriété ILayoutSlide.PlaceholderManager qui permet d’ajouter de nouvelles zones réservées à une disposition.

Ce gestionnaire propose des méthodes pour les types de zones réservées suivants :

Espace réservé PowerPoint	Méthode ILayoutPlaceholderManager
	AddContentPlaceholder(float x, float y, float width, float height)
	AddVerticalContentPlaceholder(float x, float y, float width, float height)
	AddTextPlaceholder(float x, float y, float width, float height)
	AddVerticalTextPlaceholder(float x, float y, float width, float height)
	AddPicturePlaceholder(float x, float y, float width, float height)
	AddChartPlaceholder(float x, float y, float width, float height)
	AddTablePlaceholder(float x, float y, float width, float height)
	AddSmartArtPlaceholder(float x, float y, float width, float height)
	AddMediaPlaceholder(float x, float y, float width, float height)
	AddOnlineImagePlaceholder(float x, float y, float width, float height)

Le code C# suivant montre comment ajouter de nouvelles formes de zone réservée à la disposition « Blank » :

using (var presentation = new Presentation())
{
    // Obtenir la diapositive de mise en page vierge.
    ILayoutSlide layout = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);

    // Obtenir le gestionnaire d'espaces réservés de la diapositive de mise en page.
    ILayoutPlaceholderManager placeholderManager = layout.PlaceholderManager;

    // Ajouter différents espaces réservés à la diapositive de mise en page vierge.
    placeholderManager.AddContentPlaceholder(20, 20, 310, 270);
    placeholderManager.AddVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.AddChartPlaceholder(20, 310, 310, 180);
    placeholderManager.AddTablePlaceholder(350, 310, 350, 180);

    // Ajouter une nouvelle diapositive avec la mise en page vierge.
    ISlide newSlide = presentation.Slides.AddEmptySlide(layout);

    presentation.Save("Placeholders.pptx", SaveFormat.Pptx);
}

Le résultat :

Les espaces réservés sur la diapositive de disposition

Définir la visibilité du pied de page pour une disposition de diapositive

Dans les présentations PowerPoint, les éléments de pied de page tels que la date, le numéro de diapositive et le texte personnalisé peuvent être affichés ou masqués selon la disposition. Aspose.Slides for .NET vous permet de contrôler la visibilité de ces zones réservées de pied de page. Cela est utile lorsque vous souhaitez que certaines dispositions affichent les informations de pied de page tandis que d’autres restent épurées.

Créez une instance de la classe Presentation.
Obtenez une référence à une disposition par son index.
Définissez la zone réservée du pied de page de la diapositive comme visible.
Définissez la zone réservée du numéro de diapositive comme visible.
Définissez la zone réservée de la date‑heure comme visible.
Enregistrez la présentation.

Le code C# suivant montre comment régler la visibilité du pied de page d’une diapositive :

using (Presentation presentation = new Presentation("Presentation.ppt"))
{
    ILayoutSlideHeaderFooterManager headerFooterManager = presentation.LayoutSlides[0].HeaderFooterManager;

    if (!headerFooterManager.IsFooterVisible)
    {
        headerFooterManager.SetFooterVisibility(true);
    }

    if (!headerFooterManager.IsSlideNumberVisible)
    {
        headerFooterManager.SetSlideNumberVisibility(true);
    }

    if (!headerFooterManager.IsDateTimeVisible)
    {
        headerFooterManager.SetDateTimeVisibility(true);
    }

    headerFooterManager.SetFooterText("Footer text");
    headerFooterManager.SetDateTimeText("Date and time text");

    presentation.Save("Presentation.ppt", SaveFormat.Ppt);
}

Définir la visibilité du pied de page enfant pour une diapositive

Dans les présentations PowerPoint, les éléments de pied de page tels que la date, le numéro de diapositive et le texte personnalisé peuvent être contrôlés au niveau du masque afin d’assurer la cohérence sur toutes les dispositions. Aspose.Slides for .NET vous permet de définir la visibilité et le contenu de ces zones réservées de pied de page sur le masque maître et de propager ces paramètres à toutes les dispositions enfants. Cette approche garantit une information de pied de page uniforme tout au long de votre présentation.

Créez une instance de la classe Presentation.
Obtenez une référence au masque de diapositive par son index.
Définissez les zones réservées du pied de page du masque et de tous les enfants comme visibles.
Définissez les zones réservées du numéro de diapositive du masque et de tous les enfants comme visibles.
Définissez les zones réservées de la date‑heure du masque et de tous les enfants comme visibles.
Enregistrez la présentation.

Le code C# suivant montre cette opération :

using (Presentation presentation = new Presentation("Presentation.ppt"))
{
    IMasterSlideHeaderFooterManager headerFooterManager = presentation.Masters[0].HeaderFooterManager;

    headerFooterManager.SetFooterAndChildFootersVisibility(true);
    headerFooterManager.SetSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.SetDateTimeAndChildDateTimesVisibility(true);

    headerFooterManager.SetFooterAndChildFootersText("Footer text");
    headerFooterManager.SetDateTimeAndChildDateTimesText("Date and time text");

    presentation.Save("Output.pptx", SaveFormat.Pptx);
}

FAQ

Quelle est la différence entre une diapositive maître et une diapositive de disposition ?

Une diapositive maître définit le thème global et le formatage par défaut, tandis que les diapositives de disposition précisent les agencements spécifiques des zones réservées pour différents types de contenu.

Puis‑je copier une diapositive de disposition d’une présentation à une autre ?

Oui, vous pouvez cloner une diapositive de disposition depuis la collection LayoutSlides d’une présentation et l’insérer dans une autre en utilisant la méthode AddClone.

Que se passe‑t‑il si je supprime une diapositive de disposition encore utilisée par une diapositive ?

Si vous tentez de supprimer une diapositive de disposition qui est encore référencée par au moins une diapositive de la présentation, Aspose.Slides lèvera une PptxEditException. Pour éviter cela, utilisez RemoveUnusedLayoutSlides qui supprime uniquement les dispositions non utilisées.

Comparer les diapositives Modifier la taille des diapositives de la présentation en .NET