Gérer les espaces réservés de présentation dans .NET

Modifier le texte d’un espace réservé

En utilisant Aspose.Slides for .NET, vous pouvez rechercher et modifier les espaces réservés sur les diapositives d’une présentation. Aspose.Slides vous permet d’effectuer des modifications du texte d’un espace réservé.

Prérequis : Vous devez disposer d’une présentation contenant un espace réservé. Vous pouvez créer une telle présentation avec l’application Microsoft PowerPoint standard.

Voici comment utiliser Aspose.Slides pour remplacer le texte de l’espace réservé dans cette présentation :

1. Instanciez la classe Presentation et transmettez la présentation en argument.
2. Obtenez une référence de diapositive via son indice.
3. Parcourez les formes pour trouver l’espace réservé.
4. Convertissez le type de la forme d’espace réservé en AutoShape et modifiez le texte à l’aide du TextFrame associé à l’AutoShape.
5. Enregistrez la présentation modifiée.

Ce code C# montre comment modifier le texte d’un espace réservé :

// Instancie une classe Presentation
using (Presentation pres = new Presentation("ReplacingText.pptx"))
{

    // Accède à la première diapositive
    ISlide sld = pres.Slides[0];

    // Parcourt les formes pour trouver l'espace réservé
    foreach (IShape shp in sld.Shapes)
        if (shp.Placeholder != null)
        {
            // Modifie le texte de chaque espace réservé
            ((IAutoShape)shp).TextFrame.Text = "This is a Placeholder";
        }

    // Enregistre la présentation sur le disque
    pres.Save("output_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Définir le texte d’invite dans un espace réservé

Les mises en page standard et pré‑construites contiennent des textes d’invite d’espace réservé tels que Cliquez pour ajouter un titre ou Cliquez pour ajouter un sous‑titre. Avec Aspose.Slides, vous pouvez insérer vos propres textes d’invite dans les mises en page d’espace réservé.

Ce code C# vous montre comment définir le texte d’invite dans un espace réservé :

using (Presentation pres = new Presentation("Presentation2.pptx"))
{
    ISlide slide = pres.Slides[0];
    foreach (IShape shape in slide.Slide.Shapes) // Parcourt la diapositive
    {
        if (shape.Placeholder != null && shape is AutoShape)
        {
            string text = "";
            if (shape.Placeholder.Type == PlaceholderType.CenteredTitle) // PowerPoint affiche "Cliquez pour ajouter le titre"
            {
                text = "Add Title";
            }
            else if (shape.Placeholder.Type == PlaceholderType.Subtitle) // Ajoute le sous‑titre
            {
                text = "Add Subtitle";
            }

            ((IAutoShape)shape).TextFrame.Text = text;

            Console.WriteLine($"Placeholder with text: {text}");
        }
    }

    pres.Save("Placeholders_PromptText.pptx", SaveFormat.Pptx);
}

Définir la transparence d’une image d’espace réservé

Aspose.Slides permet de définir la transparence de l’image d’arrière‑plan dans un espace réservé de texte. En ajustant la transparence de l’image dans ce cadre, vous pouvez faire ressortir le texte ou l’image (selon les couleurs du texte et de l’image).

Ce code C# montre comment définir la transparence d’un arrière‑plan d’image (à l’intérieur d’une forme) :

using (var presentation = new Presentation())
{
    IAutoShape autoShape = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    
    autoShape.FillFormat.FillType = FillType.Picture;
    autoShape.FillFormat.PictureFillFormat.Picture.Image = presentation.Images.AddImage(File.ReadAllBytes("image.png"));
    autoShape.FillFormat.PictureFillFormat.PictureFillMode = PictureFillMode.Stretch;
    autoShape.FillFormat.PictureFillFormat.Picture.ImageTransform.AddAlphaModulateFixedEffect(75);
}

FAQ

Qu’est‑ce qu’un espace réservé de base, et en quoi diffère‑t‑il d’une forme locale sur une diapositive ?

Un espace réservé de base est la forme originale sur une mise en page ou un maître dont hérite la forme de la diapositive — le type, la position et une partie du formatage proviennent de celle‑ci. Une forme locale est indépendante ; s’il n’existe pas d’espace réservé de base, l’héritage ne s’applique pas.

Comment mettre à jour tous les titres ou légendes d’une présentation sans parcourir chaque diapositive ?

Modifiez l’espace réservé correspondant sur la mise en page ou le maître. Les diapositives basées sur ces mises en page ou ce maître hériteront automatiquement de la modification.

Comment gérer les espaces réservés d’en‑tête/pied de page standard — date et heure, numéro de diapositive et texte du pied de page ?

Utilisez les gestionnaires HeaderFooter au niveau approprié (diapositives normales, mises en page, maître, notes/feuillets) pour activer ou désactiver ces espaces réservés et définir leur contenu.