Gérer les formes de présentation dans .NET

Trouver une forme sur une diapositive

Ce sujet décrira une technique simple pour faciliter la recherche d’une forme spécifique sur une diapositive sans utiliser son Id interne. Il est important de savoir que les fichiers de présentation PowerPoint n’ont aucun moyen d’identifier les formes sur une diapositive autre que par un Id unique interne. Il semble difficile pour les développeurs de trouver une forme en utilisant son Id unique interne. Toutes les formes ajoutées aux diapositives ont un texte alternatif. Nous suggérons aux développeurs d’utiliser le texte alternatif pour trouver une forme spécifique. Vous pouvez utiliser MS PowerPoint pour définir le texte alternatif des objets que vous prévoyez de modifier ultérieurement.

Après avoir défini le texte alternatif de la forme souhaitée, vous pouvez ouvrir cette présentation avec Aspose.Slides for .NET et parcourir toutes les formes ajoutées à une diapositive. À chaque itération, vous pouvez vérifier le texte alternatif de la forme et la forme dont le texte alternatif correspond sera celle dont vous avez besoin. Pour illustrer cette technique de façon plus concrète, nous avons créé une méthode, FindShape qui permet de trouver une forme spécifique dans une diapositive et renvoie simplement cette forme.

public static void Run()
{
    // Instancier une classe Presentation qui représente le fichier de présentation
    using (Presentation p = new Presentation("FindingShapeInSlide.pptx"))
    {

        ISlide slide = p.Slides[0];
        // Texte alternatif de la forme à trouver
        IShape shape = FindShape(slide, "Shape1");
        if (shape != null)
        {
            Console.WriteLine("Shape Name: " + shape.Name);
        }
    }
}
        
// Implémentation de la méthode pour trouver une forme dans une diapositive en utilisant son texte alternatif
public static IShape FindShape(ISlide slide, string alttext)
{
    // Parcourir toutes les formes à l'intérieur de la diapositive
    for (int i = 0; i < slide.Shapes.Count; i++)
    {
        // Si le texte alternatif de la diapositive correspond à celui requis alors
        // Retourner la forme
        if (slide.Shapes[i].AlternativeText.CompareTo(alttext) == 0)
            return slide.Shapes[i];
    }
    return null;
}

Cloner une forme

Pour cloner une forme sur une diapositive en utilisant Aspose.Slides for .NET :

  1. Créer une instance de la classe Presentation.
  2. Obtenir la référence d’une diapositive en utilisant son indice.
  3. Accéder à la collection de formes de la diapositive source.
  4. Ajouter une nouvelle diapositive à la présentation.
  5. Cloner les formes de la collection de formes de la diapositive source vers la nouvelle diapositive.
  6. Enregistrer la présentation modifiée au format PPTX.

L’exemple ci-dessous ajoute une forme groupée à une diapositive.

// Instancier la classe Presentation
using (Presentation srcPres = new Presentation("Source Frame.pptx"))
{
	IShapeCollection sourceShapes = srcPres.Slides[0].Shapes;
	ILayoutSlide blankLayout = srcPres.Masters[0].LayoutSlides.GetByType(SlideLayoutType.Blank);
	ISlide destSlide = srcPres.Slides.AddEmptySlide(blankLayout);
	IShapeCollection destShapes = destSlide.Shapes;
	destShapes.AddClone(sourceShapes[1], 50, 150 + sourceShapes[0].Height);
	destShapes.AddClone(sourceShapes[2]);                 
	destShapes.InsertClone(0, sourceShapes[0], 50, 150);

	// Écrire le fichier PPTX sur le disque
	srcPres.Save("CloneShape_out.pptx", SaveFormat.Pptx);
}

Supprimer une forme

Aspose.Slides for .NET permet aux développeurs de supprimer n’importe quelle forme. Pour supprimer la forme d’une diapositive, suivez les étapes ci-dessous :

  1. Créer une instance de la classe Presentation.
  2. Accéder à la première diapositive.
  3. Trouver la forme avec un AlternativeText spécifique.
  4. Supprimer la forme.
  5. Enregistrer le fichier sur le disque.
// Créer l'objet Presentation
Presentation pres = new Presentation();

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

// Ajouter une forme automatique de type rectangle
IShape shp1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
IShape shp2 = sld.Shapes.AddAutoShape(ShapeType.Moon, 160, 40, 150, 50);
String alttext = "User Defined";
int iCount = sld.Shapes.Count;
for (int i = 0; i < iCount; i++)
{
    AutoShape ashp = (AutoShape)sld.Shapes[0];
    if (String.Compare(ashp.AlternativeText, alttext, StringComparison.Ordinal) == 0)
    {
        sld.Shapes.Remove(ashp);
    }
}

// Enregistrer la présentation sur le disque
pres.Save("RemoveShape_out.pptx", SaveFormat.Pptx);

Masquer une forme

Aspose.Slides for .NET permet aux développeurs de masquer n’importe quelle forme. Pour masquer la forme d’une diapositive, suivez les étapes ci-dessous :

  1. Créer une instance de la classe Presentation.
  2. Accéder à la première diapositive.
  3. Trouver la forme avec un AlternativeText spécifique.
  4. Masquer la forme.
  5. Enregistrer le fichier sur le disque.
// Instancier la classe Presentation qui représente le PPTX
Presentation pres = new Presentation();

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

// Ajouter une forme automatique de type rectangle
IShape shp1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
IShape shp2 = sld.Shapes.AddAutoShape(ShapeType.Moon, 160, 40, 150, 50);
String alttext = "User Defined";
int iCount = sld.Shapes.Count;
for (int i = 0; i < iCount; i++)
{
	AutoShape ashp = (AutoShape)sld.Shapes[i];
	if (String.Compare(ashp.AlternativeText, alttext, StringComparison.Ordinal) == 0)
	{
		ashp.Hidden = true;
	}
}

// Enregistrer la présentation sur le disque
pres.Save("Hiding_Shapes_out.pptx", SaveFormat.Pptx);

Modifier l’ordre des formes

Aspose.Slides for .NET permet aux développeurs de réorganiser les formes. Réorganiser les formes spécifie quelle forme est au premier plan ou à l’arrière. Pour réorganiser les formes d’une diapositive, suivez les étapes ci-dessous :

  1. Créer une instance de la classe Presentation.
  2. Accéder à la première diapositive.
  3. Ajouter une forme.
  4. Ajouter du texte dans le cadre de texte de la forme.
  5. Ajouter une autre forme aux mêmes coordonnées.
  6. Réordonner les formes.
  7. Enregistrer le fichier sur le disque.
Presentation presentation1 = new Presentation("HelloWorld.pptx");
ISlide slide = presentation1.Slides[0];
IAutoShape shp3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 365, 400, 150);
shp3.FillFormat.FillType = FillType.NoFill;
shp3.AddTextFrame(" ");

ITextFrame txtFrame = shp3.TextFrame;
IParagraph para = txtFrame.Paragraphs[0];
IPortion portion = para.Portions[0];
portion.Text="Watermark Text Watermark Text Watermark Text";
shp3 = slide.Shapes.AddAutoShape(ShapeType.Triangle, 200, 365, 400, 150);
slide.Shapes.Reorder(2, shp3);
presentation1.Save( "Reshape_out.pptx", SaveFormat.Pptx);

Obtenir l’ID de forme Interop

Aspose.Slides for .NET permet aux développeurs d’obtenir un identifiant de forme unique à l’échelle de la diapositive, contrairement à la propriété UniqueId qui fournit un identifiant unique à l’échelle de la présentation. La propriété OfficeInteropShapeId a été ajoutée aux interfaces IShape et à la classe Shape. La valeur renvoyée par la propriété OfficeInteropShapeId correspond à la valeur de l’Id de l’objet Microsoft.Office.Interop.PowerPoint.Shape. Vous trouverez ci‑dessous un exemple de code.

public static void Run()
{
    using (Presentation presentation = new Presentation("Presentation.pptx"))
    {
        // Obtention de l'identifiant unique de forme dans la portée de la diapositive
        long officeInteropShapeId = presentation.Slides[0].Shapes[0].OfficeInteropShapeId;
    }
}

Définir le texte alternatif d’une forme

Aspose.Slides for .NET permet aux développeurs de définir le AlternateText d’une forme.
Les formes d’une présentation peuvent être distinguées par la propriété AlternativeText ou par le nom de la forme.
La propriété AlternativeText peut être lue ou définie à l’aide d’Aspose.Slides ainsi que de Microsoft PowerPoint.
En utilisant cette propriété, vous pouvez baliser une forme et effectuer différentes opérations telles que la suppression, le masquage ou le réordonnancement des formes sur une diapositive.
Pour définir le AlternateText d’une forme, suivez les étapes ci-dessous :

  1. Créer une instance de la classe Presentation.
  2. Accéder à la première diapositive.
  3. Ajouter n’importe quelle forme à la diapositive.
  4. Effectuer des opérations avec la forme nouvellement ajoutée.
  5. Parcourir les formes pour en trouver une.
  6. Définir l’AlternativeText.
  7. Enregistrer le fichier sur le disque.
// Instancier la classe Presentation qui représente le PPTX
Presentation pres = new Presentation();

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

// Ajouter une forme automatique de type rectangle
IShape shp1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
IShape shp2 = sld.Shapes.AddAutoShape(ShapeType.Moon, 160, 40, 150, 50);
shp2.FillFormat.FillType = FillType.Solid;
shp2.FillFormat.SolidFillColor.Color = Color.Gray;

for (int i = 0; i < sld.Shapes.Count; i++)
{
    var shape = sld.Shapes[i] as AutoShape;
    if (shape != null)
    {
        AutoShape ashp = shape;
        ashp.AlternativeText = "User Defined";
    }
}

// Enregistrer la présentation sur le disque
pres.Save("Set_AlternativeText_out.pptx", SaveFormat.Pptx);

Accéder aux formats de mise en page d’une forme

Aspose.Slides for .NET fournit une API simple pour accéder aux formats de mise en page d’une forme. Cet article montre comment accéder aux formats de mise en page.

Vous trouverez ci‑dessous un exemple de code.

using (Presentation pres = new Presentation("pres.pptx"))
{
	foreach (ILayoutSlide layoutSlide in pres.LayoutSlides)
	{
		IFillFormat[] fillFormats = layoutSlide.Shapes.Select(shape => shape.FillFormat).ToArray();
		ILineFormat[] lineFormats = layoutSlide.Shapes.Select(shape => shape.LineFormat).ToArray();
	}
}

Rendre une forme en SVG

Aspose.Slides for .NET prend désormais en charge le rendu d’une forme au format SVG. La méthode WriteAsSvg (et ses surcharges) a été ajoutée aux classes Shape et IShape. Cette méthode permet d’enregistrer le contenu de la forme sous forme de fichier SVG. Le fragment de code ci‑dessous montre comment exporter la forme d’une diapositive vers un fichier SVG.

public static void Run()
{
	string outSvgFileName = "SingleShape.svg";
	using (Presentation pres = new Presentation("TestExportShapeToSvg.pptx"))
	{
		using (Stream stream = new FileStream(outSvgFileName, FileMode.Create, FileAccess.Write))
		{
			pres.Slides[0].Shapes[0].WriteAsSvg(stream);
		}
	}
}

Aligner une forme

Grâce à la méthode surchargée SlidesUtil.AlignShape(), vous pouvez

  • aligner les formes par rapport aux marges d’une diapositive. Voir Exemple 1.
  • aligner les formes les unes par rapport aux autres. Voir Exemple 2.

L’énumération ShapesAlignmentType définit les options d’alignement disponibles.

Exemple 1

Ce code C# montre comment aligner les formes avec les indices 1,2 et 4 le long du bord supérieur d’une diapositive : Le code source ci‑dessous aligne les formes avec les indices 1,2 et 4 le long du bord supérieur de la diapositive.

using (Presentation pres = new Presentation("example.pptx"))
{
     ISlide slide = pres.Slides[0];
     IShape shape1 = slide.Shapes[1];
     IShape shape2 = slide.Shapes[2];
     IShape shape3 = slide.Shapes[4];
     SlideUtil.AlignShapes(ShapesAlignmentType.AlignTop, true, pres.Slides[0], new int[]
     {
          slide.Shapes.IndexOf(shape1),
          slide.Shapes.IndexOf(shape2),
          slide.Shapes.IndexOf(shape3)
     });
}

Exemple 2

Ce code C# montre comment aligner une collection entière de formes par rapport à la forme du bas de la collection :

using (Presentation pres = new Presentation("example.pptx"))
{
    SlideUtil.AlignShapes(ShapesAlignmentType.AlignBottom, false, pres.Slides[0].Shapes);
}

Propriétés de retournement

Dans Aspose.Slides, la classe ShapeFrame fournit le contrôle du miroir horizontal et vertical des formes via ses propriétés FlipH et FlipV. Les deux propriétés sont de type NullableBool, permettant les valeurs True pour indiquer un retournement, False pour aucun retournement, ou NotDefined pour utiliser le comportement par défaut. Ces valeurs sont accessibles depuis le Frame d’une forme.

Pour modifier les paramètres de retournement, une nouvelle instance de ShapeFrame est construite avec la position et la taille actuelles de la forme, les valeurs souhaitées pour FlipH et FlipV, et l’angle de rotation. L’attribution de cette instance au Frame de la forme et l’enregistrement de la présentation appliquent les transformations de miroir et les consignent dans le fichier de sortie.

Supposons que nous ayons un fichier sample.pptx dans lequel la première diapositive contient une seule forme avec les paramètres de retournement par défaut, comme indiqué ci‑dessous.

La forme à retourner

L’exemple de code suivant récupère les propriétés de retournement actuelles de la forme et la retourne à la fois horizontalement et verticalement.

using (Presentation presentation = new Presentation("sample.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];

    // Récupérer la propriété de retournement horizontal de la forme.
    NullableBool horizontalFlip = shape.Frame.FlipH;
    Console.WriteLine($"Horizontal flip: {horizontalFlip}");

    // Récupérer la propriété de retournement vertical de la forme.
    NullableBool verticalFlip = shape.Frame.FlipV;
    Console.WriteLine($"Vertical flip: {verticalFlip}");

    float x = shape.Frame.X;
    float y = shape.Frame.Y;
    float width = shape.Frame.Width;
    float height = shape.Frame.Height;
    NullableBool flipH = NullableBool.True; // Retourner horizontalement.
    NullableBool flipV = NullableBool.True; // Retourner verticalement.
    float rotation = shape.Frame.Rotation;

    shape.Frame = new ShapeFrame(x, y, width, height, flipH, flipV, rotation);

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

Le résultat :

La forme retournée

FAQ

Puis‑je combiner des formes (union/intersection/soustraction) sur une diapositive comme dans un éditeur de bureau ?

Il n’existe pas d’API d’opération booléenne intégrée. Vous pouvez l’approximer en construisant vous‑même le contour souhaité — par ex., calculer la géométrie résultante (via GeometryPath) et créer une nouvelle forme avec ce contour, en supprimant éventuellement les formes d’origine.

Comment puis‑je contrôler l’ordre d’empilement (z‑order) afin qu’une forme reste toujours « au premier plan » ?

Modifiez l’ordre d’insertion/déplacement au sein de la collection shapes de la diapositive. Pour des résultats prévisibles, finalisez le z‑order après toutes les autres modifications de la diapositive.

Puis‑je « verrouiller » une forme pour empêcher les utilisateurs de la modifier dans PowerPoint ?

Oui. Définissez les indicateurs de protection au niveau de la forme (shape-level protection flags) (par ex., verrouiller la sélection, le déplacement, le redimensionnement, les modifications de texte). Si nécessaire, appliquez des restrictions similaires sur le maître ou la mise en page. Notez qu’il s’agit d’une protection au niveau de l’interface utilisateur, pas d’une fonction de sécurité ; pour une protection plus forte, combinez‑la avec des restrictions au niveau du fichier, telles que les recommandations en lecture seule ou les mots de passe (read‑only recommendations or passwords).

Appliquer des effets de forme aux présentations en .NET Obtenir les propriétés effectives des formes à partir des présentations en .NET