Manipulations de Formes
Trouver une Forme dans une Diapositive
Ce sujet décrira une technique simple pour faciliter aux développeurs 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 ne disposent d’aucune méthode pour identifier les formes sur une diapositive, sauf 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 pour les objets que vous prévoyez de modifier à l’avenir.
Après avoir défini le texte alternatif de la forme désirée, vous pouvez ensuite ouvrir cette présentation en utilisant Aspose.Slides pour C++ et itérer à travers toutes les formes ajoutées à une diapositive. À chaque itération, vous pouvez vérifier le texte alternatif de la forme et la forme avec le texte alternatif correspondant serait celle requise par vous. Pour démontrer cette technique de manière plus efficace, nous avons créé une méthode, FindShape qui fait le tour afin de trouver une forme spécifique dans une diapositive et retourne simplement cette forme.
Cloner une Forme
Pour cloner une forme sur une diapositive en utilisant Aspose.Slides pour C++ :
- Créez une instance de la Presentation classe.
- Obtenez la référence d’une diapositive en utilisant son index.
- Accédez à la collection de formes de la diapositive source.
- Ajoutez une nouvelle diapositive à la présentation.
- Clonez les formes de la collection de formes de la diapositive source vers la nouvelle diapositive.
- Enregistrez la présentation modifiée sous forme de fichier PPTX.
L’exemple ci-dessous ajoute une forme groupée à une diapositive.
Supprimer une Forme
Aspose.Slides pour C++ permet aux développeurs de supprimer n’importe quelle forme. Pour supprimer la forme d’une diapositive, veuillez suivre les étapes ci-dessous :
- Créez une instance de Presentation classe.
- Accédez à la première diapositive.
- Trouvez la forme avec un AlternativeText spécifique.
- Supprimez la forme.
- Enregistrez le fichier sur le disque.
Cacher une Forme
Aspose.Slides pour C++ permet aux développeurs de cacher n’importe quelle forme. Pour cacher la forme d’une diapositive, veuillez suivre les étapes ci-dessous :
- Créez une instance de Presentation classe.
- Accédez à la première diapositive.
- Trouvez la forme avec un AlternativeText spécifique.
- Cachez la forme.
- Enregistrez le fichier sur le disque.
Changer l’Ordre des Formes
Aspose.Slides pour C++ permet aux développeurs de réorganiser les formes. La réorganisation des formes spécifie quelle forme est à l’avant ou quelle forme est à l’arrière. Pour réorganiser la forme d’une diapositive, veuillez suivre les étapes ci-dessous :
- Créez une instance de Presentation classe.
- Accédez à la première diapositive.
- Ajoutez une forme.
- Ajoutez du texte dans le cadre de texte de la forme.
- Ajoutez une autre forme avec les mêmes coordonnées.
- Réorganisez les formes.
- Enregistrez le fichier sur le disque.
Obtenir l’ID de la Forme Interop
Aspose.Slides pour C++ permet aux développeurs d’obtenir un identifiant unique de forme dans le scope de la diapositive par rapport à la propriété UniqueId, qui permet d’obtenir un identifiant unique dans le scope de la présentation. La propriété OfficeInteropShapeId a été ajoutée aux interfaces IShape et à la classe Shape respectivement. La valeur retournée par la propriété OfficeInteropShapeId correspond à la valeur de l’Id de l’objet Microsoft.Office.Interop.PowerPoint.Shape. Ci-dessous, un exemple de code est donné.
Définir la Propriété AlternativeText
Aspose.Slides pour C++ permet aux développeurs de définir l’AlternateText de n’importe quelle forme. Pour définir l’AlternateText d’une forme, veuillez suivre les étapes ci-dessous :
- Créez une instance de Presentation classe.
- Accédez à la première diapositive.
- Ajoutez n’importe quelle forme à la diapositive.
- Faites quelques travaux avec la forme nouvellement ajoutée.
- Parcourez les formes pour trouver une forme.
- Définissez le AlternativeText.
- Enregistrez le fichier sur le disque.
Accéder aux Formats de Mise en Page pour une Forme
Aspose.Slides pour C++ permet aux développeurs d’accéder aux formats de mise en page pour une forme. Cet article démontre comment vous pouvez accéder aux propriétés FillFormat et LineFormat pour une forme.
Ci-dessous, un exemple de code est donné.
Rendre une Forme en tant que SVG
Maintenant, Aspose.Slides pour C++ prend en charge le rendu d’une forme en tant que svg. La méthode WriteAsSvg (et ses surcharges) a été ajoutée à la classe Shape et à l’interface IShape. Cette méthode permet d’enregistrer le contenu de la forme en tant que fichier SVG. L’extrait de code ci-dessous montre comment exporter la forme d’une diapositive vers un fichier SVG.
String outSvgFileName = u"SingleShape.svg";
auto pres = System::MakeObject<Presentation>(u"TestExportShapeToSvg.pptx");
auto stream = System::MakeObject<FileStream>(outSvgFileName, FileMode::Create, FileAccess::Write);
pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)->WriteAsSvg(stream);
Alignement des Formes
Aspose.Slides permet d’aligner les formes soit par rapport aux marges de la diapositive, soit l’une par rapport à l’autre. À cet effet, une méthode surchargée SlidesUtil.AlignShapes() a été ajoutée. L’énumération ShapesAlignmentType définit les options d’alignement possibles.
Exemple 1
Le code source ci-dessous aligne les formes avec les indices 1, 2 et 4 le long de la bordure supérieure de la diapositive.
SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"example.pptx");
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);
SharedPtr<IShape> shape1 = slide->get_Shapes()->idx_get(1);
SharedPtr<IShape> shape2 = slide->get_Shapes()->idx_get(2);
SharedPtr<IShape> shape3 = slide->get_Shapes()->idx_get(4);
SlideUtil::AlignShapes(ShapesAlignmentType::AlignTop, true, pres->get_Slides()->idx_get(0),
System::MakeArray<int32_t>(
{
slide->get_Shapes()->IndexOf(shape1),
slide->get_Shapes()->IndexOf(shape2),
slide->get_Shapes()->IndexOf(shape3)
}));
Exemple 2
L’exemple ci-dessous montre comment aligner l’intégralité de la collection de formes par rapport à la toute dernière forme de la collection.
SharedPtr<Presentation> pres = MakeObject<Presentation>(u"example.pptx");
SlideUtil::AlignShapes(ShapesAlignmentType::AlignBottom, false, pres->get_Slides()->idx_get(0)->get_Shapes());