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.

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C

	// The path to the documents directory.
	const String outPath = u"../out/FindShapeInSlide_out.pptx";
	const String templatePath = u"../templates/FindingShapeInSlide.pptx";

	// Load the desired the presentation
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// Access first slide
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	SharedPtr<IShape> shape = Aspose::Slides::Util::SlideUtil::FindShape(slide, u"Shape1");
	if (shape != nullptr)
	{
		Console::WriteLine(u"Shape Name: " + shape->get_Name());
		Console::WriteLine(u"Shape Alternative Tex: " + shape->get_AlternativeText());
	}

Cloner une Forme

Pour cloner une forme sur une diapositive en utilisant Aspose.Slides pour C++ :

1. Créez une instance de la Presentation classe.
2. Obtenez la référence d’une diapositive en utilisant son index.
3. Accédez à la collection de formes de la diapositive source.
4. Ajoutez une nouvelle diapositive à la présentation.
5. Clonez les formes de la collection de formes de la diapositive source vers la nouvelle diapositive.
6. Enregistrez la présentation modifiée sous forme de fichier PPTX.

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

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C

	// The path to the documents directory.
	const String outPath = u"../out/CloneShapes_out.pptx";
	const String templatePath = u"../templates/Source Frame.pptx";

	// Load the desired the presentation
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// Access first slide
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accessing shapes collection for selected slide
	SharedPtr<IShapeCollection> sourceShapes = slide->get_Shapes();

	SharedPtr<ILayoutSlide> blankLayout = pres->get_Masters()->idx_get(0)->get_LayoutSlides()->GetByType(SlideLayoutType::Blank);
	SharedPtr<ISlide> destSlide = pres->get_Slides()->AddEmptySlide(blankLayout);
	SharedPtr<IShapeCollection> destShapes = destSlide->get_Shapes();
	destShapes->AddClone(sourceShapes->idx_get(1), 50, 150 + sourceShapes->idx_get(0)->get_Height());
	destShapes->AddClone(sourceShapes->idx_get(2));
	destShapes->InsertClone(0, sourceShapes->idx_get(0), 50, 150);

	//Write the PPTX to Disk
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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 :

1. Créez une instance de Presentation classe.
2. Accédez à la première diapositive.
3. Trouvez la forme avec un AlternativeText spécifique.
4. Supprimez la forme.
5. Enregistrez le fichier sur le disque.

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C

	// The path to the documents directory.
	const String outPath = u"../out/RemoveShape_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Load the desired the presentation
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	// Access first slide
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accessing shapes collection for selected slide
	SharedPtr<IShapeCollection> shapes = slide->get_Shapes();

	// Now create effect "PathFootball" for existing shape from scratch.
	SharedPtr<IAutoShape> autoShape1 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
	SharedPtr<IAutoShape> autoShape2 = slide->get_Shapes()->AddAutoShape(ShapeType::Moon, 160, 40, 150, 50);

	String alttext = u"User Defined";

	int iCount = slide->get_Shapes()->get_Count();

	for (int i = 0; i < iCount; i++)
	{
		// Accessing the added shape
		SharedPtr<Shape>  ashape = DynamicCast<Aspose::Slides::Shape>(slide->get_Shapes()->idx_get(i));

		if (String::Compare(ashape->get_AlternativeText(), alttext, StringComparison::Ordinal) == 0)
		{
			slide->get_Shapes()->Remove(ashape);
		}
	}

	//Write the PPTX to Disk
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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 :

1. Créez une instance de Presentation classe.
2. Accédez à la première diapositive.
3. Trouvez la forme avec un AlternativeText spécifique.
4. Cachez la forme.
5. Enregistrez le fichier sur le disque.

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C

	// The path to the documents directory.
	const String outPath = u"../out/Hidingshapes_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Load the desired the presentation
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	// Access first slide
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accessing shapes collection for selected slide
	SharedPtr<IShapeCollection> shapes = slide->get_Shapes();

	// Now create effect "PathFootball" for existing shape from scratch.
	SharedPtr<IAutoShape> autoShape1 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
	SharedPtr<IAutoShape> autoShape2 = slide->get_Shapes()->AddAutoShape(ShapeType::Moon, 160, 40, 150, 50);

	String alttext = u"User Defined";

	int iCount = slide->get_Shapes()->get_Count();
	
	for (int i = 0; i < iCount; i++)
	{
		// Accessing the added shape
		SharedPtr<AutoShape>  ashape = DynamicCast<Aspose::Slides::AutoShape>(slide->get_Shapes()->idx_get(i));

		if (String::Compare(ashape->get_AlternativeText(), alttext, StringComparison::Ordinal) == 0)
		{
			ashape->set_Hidden(true);
		}
	}

	//Write the PPTX to Disk
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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 :

1. Créez une instance de Presentation classe.
2. Accédez à la première diapositive.
3. Ajoutez une forme.
4. Ajoutez du texte dans le cadre de texte de la forme.
5. Ajoutez une autre forme avec les mêmes coordonnées.
6. Réorganisez les formes.
7. Enregistrez le fichier sur le disque.

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// The path to the documents directory.
const String outPath = u"../out/ChangeShapeOrder_out.pptx";
const String templatePath = u"../templates/HelloWorld.pptx";

// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

// Access first slide
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// Add an AutoShape of Rectangle type
SharedPtr<IAutoShape>  ashp = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);

ashp->get_FillFormat()->set_FillType(FillType::NoFill);

// Add TextFrame to the Rectangle
ashp->AddTextFrame(u" ");

// Accessing the text frame
SharedPtr<ITextFrame>  txtFrame = ashp->get_TextFrame();

// Create the Paragraph object for text frame
SharedPtr<IParagraph> paragraph = txtFrame->get_Paragraphs()->idx_get(0);

// Create Portion object for paragraph
SharedPtr<IPortion> portion = paragraph->get_Portions()->idx_get(0);
portion->set_Text(u"Watermark Text Watermark Text Watermark Text");

//Adding another shape
SharedPtr<IAutoShape>  ashape2 = slide->get_Shapes()->AddAutoShape(ShapeType::Triangle, 200, 365, 400, 150);

//Reorder shape
slide->get_Shapes()->Reorder(2, ashape2);


// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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é.

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C

	// The path to the documents directory.
	const String outPath = u"../out/FindShapeInSlide_out.pptx";
	const String templatePath = u"../templates/FindingShapeInSlide.pptx";

	// Load the desired the presentation
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);
	
	long officeInteropShapeId = 0;
	// Getting unique shape identifier in slide scope
//	 officeInteropShapeId = pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)->get_OfficeInteropShapeId();

	Console::WriteLine(u"Office Interop Shape ID: " + officeInteropShapeId);
	

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 :

1. Créez une instance de Presentation classe.
2. Accédez à la première diapositive.
3. Ajoutez n’importe quelle forme à la diapositive.
4. Faites quelques travaux avec la forme nouvellement ajoutée.
5. Parcourez les formes pour trouver une forme.
6. Définissez le AlternativeText.
7. Enregistrez le fichier sur le disque.

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C

	// The path to the documents directory.
	const String outPath = u"../out/SetAlternativeText_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Load the desired the presentation
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	// Access first slide
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accessing shapes collection for selected slide
	SharedPtr<IShapeCollection> shapes = slide->get_Shapes();

	// Now create effect "PathFootball" for existing shape from scratch.
	SharedPtr<IAutoShape> autoShape1 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
	SharedPtr<IAutoShape> autoShape2 = slide->get_Shapes()->AddAutoShape(ShapeType::Moon, 160, 40, 150, 50);

	String alttext = u"User Defined";

	int iCount = slide->get_Shapes()->get_Count();

	for (int i = 0; i < iCount; i++)
	{
		// Accessing the added shape
		SharedPtr<IShape> shape = slide->get_Shapes()->idx_get(i);
		SharedPtr<AutoShape>  ashape = DynamicCast<Aspose::Slides::AutoShape>(shape);

		if (ashape != nullptr)
		{
			ashape->set_AlternativeText (u"User Defined " +(i+1));
		}
	}

	//Write the PPTX to Disk
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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é.

	// The path to the documents directory.
	const String outPath = u"../templates/pres.pptx";

	//Instantiate Presentation class that represents PPTX file
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	
	for (int x = 0; x < pres->get_LayoutSlides()->get_Count(); x++) 
	{

			SharedPtr<IShapeCollection> shapeCollection = pres->get_LayoutSlides()->idx_get(x)->get_Shapes();
			
					

			for (int i = 0; i < shapeCollection->get_Count(); i++) {
			
				SharedPtr<IShape> shape = shapeCollection->idx_get(i);

				System::Console::WriteLine(shape->get_FillFormat());
			
			}


			for (int j = 0; j < shapeCollection->get_Count(); j++) {

				SharedPtr<IShape> shape = shapeCollection->idx_get(j);
				
				System::Console::WriteLine(shape->get_LineFormat());
			}

	}

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