# Gérer les paragraphes de texte PowerPoint en C++ > Maîtrisez la mise en forme des paragraphes avec Aspose.Slides pour C++—optimisez l'alignement, l'espacement et le style dans les présentations PPT, PPTX et ODP en C++. Source: https://docs.aspose.com/slides/fr/cpp/manage-paragraph/ Updated: 2026-04-10 Aspose.Slides fournit toutes les interfaces et classes dont vous avez besoin pour travailler avec les textes, paragraphes et portions de PowerPoint en C++. * Aspose.Slides fournit l’interface [ITextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) pour vous permettre d’ajouter des objets qui représentent un paragraphe. Un objet `ITextFame` peut contenir un ou plusieurs paragraphes (chaque paragraphe est créé par un retour chariot). * Aspose.Slides fournit l’interface [IParagraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraph/) pour vous permettre d’ajouter des objets qui représentent des portions. Un objet `IParagraph` peut contenir une ou plusieurs portions (collection d’objets iPortions). * Aspose.Slides fournit l’interface [IPortion](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iportion/) pour vous permettre d’ajouter des objets qui représentent des textes et leurs propriétés de mise en forme. Un objet `IParagraph` peut gérer des textes avec différentes propriétés de mise en forme grâce à ses objets sous‑jacents `IPortion`. ## **Ajouter plusieurs paragraphes contenant plusieurs portions** Ces étapes montrent comment ajouter un cadre de texte contenant 3 paragraphes et chaque paragraphe contenant 3 portions : 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la référence de la diapositive souhaitée via son indice. 3. Ajoutez un rectangle [IAutoShape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) à la diapositive. 4. Récupérez le ITextFrame associé à l’[IAutoShape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/). 5. Créez deux objets [IParagraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraph/) et ajoutez‑les à la collection `IParagraphs` du [ITextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/). 6. Créez trois objets [IPortion](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iportion/) pour chaque nouveau `IParagraph` (deux objets Portion pour le paragraphe par défaut) et ajoutez chaque objet `IPortion` à la collection IPortion de chaque `IParagraph`. 7. Définissez du texte pour chaque portion. 8. Appliquez les options de mise en forme souhaitées à chaque portion en utilisant les propriétés de mise en forme exposées par l’objet `IPortion`. 9. Enregistrez la présentation modifiée. Ce code C++ implémente les étapes d’ajout de paragraphes contenant des portions : ```c++ // Le chemin du répertoire des documents. const String outPath = u"../out/MultipleParagraphs_out.pptx"; // Charger la présentation souhaitée SharedPtr pres = MakeObject(); // Accéder à la première diapositive SharedPtr sld = pres->get_Slides()->idx_get(0); // Ajouter une AutoShape de type Rectangle SharedPtr ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50); // Ajouter un TextFrame au rectangle SharedPtr tf=ashp->AddTextFrame(u" "); // Accéder au premier paragraphe SharedPtr para0 = tf->get_Paragraphs()->idx_get(0); SharedPtr port01 = MakeObject(); SharedPtr port02 = MakeObject(); para0->get_Portions()->Add(port01); para0->get_Portions()->Add(port02); // Ajouter le deuxième paragraphe SharedPtr para1 = MakeObject(); tf->get_Paragraphs()->Add(para1); SharedPtr port10 = MakeObject(); SharedPtr port11 = MakeObject(); SharedPtr port12 = MakeObject(); para1->get_Portions()->Add(port10); para1->get_Portions()->Add(port11); para1->get_Portions()->Add(port12); // Ajouter le troisième paragraphe SharedPtr para2 = MakeObject(); tf->get_Paragraphs()->Add(para2); SharedPtr port20 = MakeObject(); SharedPtr port21 = MakeObject(); SharedPtr port22 = MakeObject(); para2->get_Portions()->Add(port20); para2->get_Portions()->Add(port21); para2->get_Portions()->Add(port22); for (int i = 0; i < 3; i++) { for (int j = 0; j < 3; j++) { tf->get_Paragraphs()->idx_get(i)->get_Portions()->idx_get(j)->set_Text(u"Portion_"+j); SharedPtrformat = tf->get_Paragraphs()->idx_get(i)->get_Portions()->idx_get(j)->get_PortionFormat(); if (j == 0) { format->get_FillFormat()->set_FillType(FillType::Solid); format->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red()); format->set_FontBold(NullableBool::True); format->set_FontHeight(15); } else if (j == 1) { format->get_FillFormat()->set_FillType(FillType::Solid); format->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue()); format->set_FontBold(NullableBool::True); format->set_FontHeight(18); } } } // Enregistrer le PPTX sur le disque pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx); ``` ## **Gérer les puces de paragraphe** Les listes à puces vous aident à organiser et présenter des informations rapidement et efficacement. Les paragraphes à puces sont toujours plus faciles à lire et à comprendre. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la référence de la diapositive souhaitée via son indice. 3. Ajoutez une [autoshape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) à la diapositive sélectionnée. 4. Accédez au [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) de l’autoshape. 5. Supprimez le paragraphe par défaut dans le `TextFrame`. 6. Créez la première instance de paragraphe en utilisant la classe [Paragraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraph/). 7. Définissez le `Type` de puce du paragraphe sur `Symbol` et définissez le caractère de puce. 8. Définissez le `Text` du paragraphe. 9. Définissez l’`Indent` du paragraphe pour la puce. 10. Définissez une couleur pour la puce. 11. Définissez une hauteur pour la puce. 12. Ajoutez le nouveau paragraphe à la collection de paragraphes du `TextFrame`. 13. Ajoutez le deuxième paragraphe et répétez le processus décrit aux étapes 7 à 13. 14. Enregistrez la présentation. Ce code C++ montre comment ajouter une puce de paragraphe : ```c++ // Le chemin du répertoire des documents. const String outPath = u"../out/ParagraphBullets_out.pptx"; const String templatePath = u"../templates/DefaultFonts.pptx"; const String ImagePath = u"../templates/Tulips.jpg"; // Charger la présentation souhaitée SharedPtr pres = MakeObject(); // Accéder à la première diapositive SharedPtr sld = pres->get_Slides()->idx_get(0); // Ajouter une AutoShape de type Rectangle SharedPtr ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50); // Ajouter un TextFrame au rectangle ashp->AddTextFrame(u""); // Accéder au cadre de texte SharedPtr txtFrame = ashp->get_TextFrame(); txtFrame->get_Paragraphs()->Clear(); // Créer l'objet Paragraph pour le cadre de texte SharedPtr paragraph = MakeObject(); //Définir le texte paragraph->set_Text(u"Welcome to Aspose.Slides"); // Définir le retrait de la puce paragraph->get_ParagraphFormat()->set_Indent (25); // Définir la couleur de la puce paragraph->get_ParagraphFormat()->get_Bullet()->get_Color()->set_ColorType ( ColorType::RGB); paragraph->get_ParagraphFormat()->get_Bullet()->get_Color()->set_Color(Color::get_Black()); // définir IsBulletHardColor à true pour utiliser sa propre couleur de puce paragraph->get_ParagraphFormat()->get_Bullet()->set_IsBulletHardColor(NullableBool::True); // Définir la hauteur de la puce paragraph->get_ParagraphFormat()->get_Bullet()->set_Height(100); // Ajouter le paragraphe au cadre de texte txtFrame->get_Paragraphs()->Add(paragraph); // Créer le deuxième paragraphe // Créer l'objet Paragraph pour le cadre de texte SharedPtr paragraph2 = MakeObject(); //Définir le texte paragraph2->set_Text(u"This is numbered bullet"); // Définir le type et le style de la puce du paragraphe paragraph2->get_ParagraphFormat()->get_Bullet()->set_Type ( BulletType::Numbered); paragraph2->get_ParagraphFormat()->get_Bullet()->set_NumberedBulletStyle ( NumberedBulletStyle::BulletCircleNumWDBlackPlain); // Définir le retrait de la puce paragraph2->get_ParagraphFormat()->set_Indent(25); // Définir la couleur de la puce paragraph2->get_ParagraphFormat()->get_Bullet()->get_Color()->set_ColorType(ColorType::RGB); paragraph2->get_ParagraphFormat()->get_Bullet()->get_Color()->set_Color(Color::get_Black()); // définir IsBulletHardColor à true pour utiliser sa propre couleur de puce paragraph2->get_ParagraphFormat()->get_Bullet()->set_IsBulletHardColor(NullableBool::True); // Définir la hauteur de la puce paragraph2->get_ParagraphFormat()->get_Bullet()->set_Height(100); // Ajouter le paragraphe au cadre de texte txtFrame->get_Paragraphs()->Add(paragraph2); // Enregistrer le PPTX sur le disque pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx); ``` ## **Gérer les puces image** Les listes à puces vous aident à organiser et présenter des informations rapidement et efficacement. Les paragraphes image sont faciles à lire et à comprendre. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la référence de la diapositive souhaitée via son indice. 3. Ajoutez une [autoshape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) à la diapositive. 4. Accédez au [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) de l’autoshape. 5. Supprimez le paragraphe par défaut dans le `TextFrame`. 6. Créez la première instance de paragraphe en utilisant la classe [Paragraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraph/). 7. Chargez l’image dans [IPPImage](https://reference.aspose.com/slides/fr/cpp/aspose.slides/ippimage/). 8. Définissez le type de puce sur [Picture](https://reference.aspose.com/slides/fr/cpp/aspose.slides/ippimage/) et définissez l’image. 9. Définissez le `Text` du paragraphe. 10. Définissez l’`Indent` du paragraphe pour la puce. 11. Définissez une couleur pour la puce. 12. Définissez une hauteur pour la puce. 13. Ajoutez le nouveau paragraphe à la collection de paragraphes du `TextFrame`. 14. Ajoutez le deuxième paragraphe et répétez le processus basé sur les étapes précédentes. 15. Enregistrez la présentation modifiée. Ce code C++ montre comment ajouter et gérer des puces image : ```c++ // Instancie une classe Presentation qui représente un fichier PPTX System::SharedPtr presentation = System::MakeObject(); // Accède à la première diapositive System::SharedPtr slide = presentation->get_Slide(0); // Instancie l'image pour les puces System::SharedPtr image = Images::FromFile(u"bullets.png"); System::SharedPtr ippxImage = presentation->get_Images()->AddImage(image); // Ajoute et accède à l'Autoshape System::SharedPtr autoShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f); // Accède au cadre de texte de l'autoshape System::SharedPtr textFrame = autoShape->get_TextFrame(); // Supprime le paragraphe par défaut System::SharedPtr paragraphs = textFrame->get_Paragraphs(); paragraphs->RemoveAt(0); // Crée un nouveau paragraphe System::SharedPtr paragraph = System::MakeObject(); paragraph->set_Text(u"Welcome to Aspose.Slides"); // Définit le style de puce du paragraphe et l'image paragraph->get_ParagraphFormat()->get_Bullet()->set_Type(BulletType::Picture); paragraph->get_ParagraphFormat()->get_Bullet()->get_Picture()->set_Image(ippxImage); // Définit la hauteur de la puce paragraph->get_ParagraphFormat()->get_Bullet()->set_Height(100.0f); // Ajoute le paragraphe au cadre de texte paragraphs->Add(paragraph); // Enregistre la présentation au format PPTX presentation->Save(u"ParagraphPictureBulletsPPTX_out.pptx", SaveFormat::Pptx); // Enregistre la présentation au format PPT presentation->Save(u"ParagraphPictureBulletsPPT_out.ppt", SaveFormat::Ppt); ``` ## **Gérer les puces multilevel** Les listes à puces vous aident à organiser et présenter des informations rapidement et efficacement. Les puces à plusieurs niveaux sont faciles à lire et à comprendre. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la référence de la diapositive souhaitée via son indice. 3. Ajoutez une [autoshape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) dans la nouvelle diapositive. 4. Accédez au [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) de l’autoshape. 5. Supprimez le paragraphe par défaut dans le `TextFrame`. 6. Créez la première instance de paragraphe via la classe [Paragraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraph/) et définissez la profondeur à 0. 7. Créez la deuxième instance de paragraphe via la classe `Paragraph` et définissez la profondeur à 1. 8. Créez la troisième instance de paragraphe via la classe `Paragraph` et définissez la profondeur à 2. 9. Créez la quatrième instance de paragraphe via la classe `Paragraph` et définissez la profondeur à 3. 10. Ajoutez les nouveaux paragraphes à la collection de paragraphes du `TextFrame`. 11. Enregistrez la présentation modifiée. Ce code C++ montre comment ajouter et gérer des puces multilevel : ```c++ // Instancie une classe Presentation qui représente un fichier PPTX System::SharedPtr pres = System::MakeObject(); // Accède à la première diapositive System::SharedPtr slide = pres->get_Slide(0); // Ajoute et accède à l'Autoshape System::SharedPtr aShp = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f); // Accède au cadre de texte de l'autoshape créé System::SharedPtr text = aShp->AddTextFrame(u""); // Efface le paragraphe par défaut text->get_Paragraphs()->Clear(); // Ajoute le premier paragraphe System::SharedPtr para1 = System::MakeObject(); para1->set_Text(u"Content"); System::SharedPtr para1Format = para1->get_ParagraphFormat(); System::SharedPtr bullet1Format = para1Format->get_Bullet(); bullet1Format->set_Type(BulletType::Symbol); bullet1Format->set_Char(System::Convert::ToChar(8226)); System::SharedPtr defaultFillFormat1 = para1Format->get_DefaultPortionFormat()->get_FillFormat(); defaultFillFormat1->set_FillType(FillType::Solid); defaultFillFormat1->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black()); // Définit le niveau de puce para1Format->set_Depth(0); // Ajoute le deuxième paragraphe System::SharedPtr para2 = System::MakeObject(); para2->set_Text(u"Second Level"); System::SharedPtr para2Format = para2->get_ParagraphFormat(); System::SharedPtr bullet2Format = para2Format->get_Bullet(); bullet2Format->set_Type(BulletType::Symbol); bullet2Format->set_Char(u'-'); System::SharedPtr defaultFillFormat2 = para2Format->get_DefaultPortionFormat()->get_FillFormat(); defaultFillFormat2->set_FillType(FillType::Solid); defaultFillFormat2->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black()); // Définit le niveau de puce para2Format->set_Depth(1); // Ajoute le troisième paragraphe System::SharedPtr para3 = System::MakeObject(); para3->set_Text(u"Third Level"); System::SharedPtr para3Format = para3->get_ParagraphFormat(); System::SharedPtr bullet3Format = para3Format->get_Bullet(); bullet3Format->set_Type(BulletType::Symbol); bullet3Format->set_Char(System::Convert::ToChar(8226)); System::SharedPtr defaultFillFormat3 = para3Format->get_DefaultPortionFormat()->get_FillFormat(); defaultFillFormat3->set_FillType(FillType::Solid); defaultFillFormat3->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black()); // Définit le niveau de puce para3Format->set_Depth(2); // Ajoute le quatrième paragraphe System::SharedPtr para4 = System::MakeObject(); para4->set_Text(u"Fourth Level"); System::SharedPtr para4Format = para4->get_ParagraphFormat(); System::SharedPtr bullet4Format = para4Format->get_Bullet(); bullet4Format->set_Type(BulletType::Symbol); bullet4Format->set_Char(u'-'); System::SharedPtr defaultFillFormat4 = para4Format->get_DefaultPortionFormat()->get_FillFormat(); defaultFillFormat4->set_FillType(FillType::Solid); defaultFillFormat4->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black()); // Définit le niveau de puce para4Format->set_Depth(3); // Ajoute les paragraphes à la collection System::SharedPtr paragraphs = text->get_Paragraphs(); paragraphs->Add(para1); paragraphs->Add(para2); paragraphs->Add(para3); paragraphs->Add(para4); // Enregistre la présentation au format PPTX pres->Save(u"MultilevelBullet.pptx", SaveFormat::Pptx); ``` ## **Gérer un paragraphe avec une liste numérotée personnalisée** L’interface [IBulletFormat](https://reference.aspose.com/slides/fr/cpp/aspose.slides/ibulletformat/) fournit la propriété [NumberedBulletStartWith](https://reference.aspose.com/slides/fr/cpp/aspose.slides/ibulletformat/set_numberedbulletstartwith/) et d’autres qui vous permettent de gérer les paragraphes avec une numérotation ou une mise en forme personnalisée. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la diapositive contenant le paragraphe. 3. Ajoutez une [autoshape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) à la diapositive. 4. Accédez au [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) de l’autoshape. 5. Supprimez le paragraphe par défaut dans le `TextFrame`. 6. Créez la première instance de paragraphe via la classe [Paragraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraph/) et définissez [NumberedBulletStartWith](https://reference.aspose.com/slides/fr/cpp/aspose.slides/ibulletformat/set_numberedbulletstartwith/) à 2. 7. Créez la deuxième instance de paragraphe via la classe `Paragraph` et définissez `NumberedBulletStartWith` à 3. 8. Créez la troisième instance de paragraphe via la classe `Paragraph` et définissez `NumberedBulletStartWith` à 7. 9. Ajoutez les nouveaux paragraphes à la collection de paragraphes du `TextFrame`. 10. Enregistrez la présentation modifiée. Ce code C++ montre comment ajouter et gérer des paragraphes avec une numérotation ou une mise en forme personnalisée : ```c++ auto presentation = System::MakeObject(); auto shape = presentation->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f); // Accède au cadre de texte de l'autoshape créé System::SharedPtr textFrame = shape->get_TextFrame(); // Supprime le paragraphe par défaut existant textFrame->get_Paragraphs()->RemoveAt(0); // Première liste auto paragraph1 = System::MakeObject(); paragraph1->set_Text(u"bullet 2"); auto paragraph1Format = paragraph1->get_ParagraphFormat(); paragraph1Format->set_Depth(4); auto bullet1Format = paragraph1Format->get_Bullet(); bullet1Format->set_NumberedBulletStartWith(2); bullet1Format->set_Type(BulletType::Numbered); textFrame->get_Paragraphs()->Add(paragraph1); auto paragraph2 = System::MakeObject(); paragraph2->set_Text(u"bullet 3"); auto paragraph2Format = paragraph2->get_ParagraphFormat(); paragraph2Format->set_Depth(4); auto bullet2Format = paragraph2Format->get_Bullet(); bullet2Format->set_NumberedBulletStartWith(3); bullet2Format->set_Type(BulletType::Numbered); textFrame->get_Paragraphs()->Add(paragraph2); auto paragraph5 = System::MakeObject(); paragraph5->set_Text(u"bullet 7"); auto paragraph5Format = paragraph5->get_ParagraphFormat(); paragraph5Format->set_Depth(4); auto bullet5Format = paragraph5Format->get_Bullet(); bullet5Format->set_NumberedBulletStartWith(7); bullet5Format->set_Type(BulletType::Numbered); textFrame->get_Paragraphs()->Add(paragraph5); presentation->Save(u"SetCustomBulletsNumber-slides.pptx", SaveFormat::Pptx); ``` ## **Définir l’indent de première ligne pour un paragraphe** Utilisez la méthode [IParagraphFormat::set_Indent](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_indent/) pour contrôler l’indent de première ligne d’un paragraphe. Cette méthode ne déplace que la première ligne par rapport à la marge gauche du paragraphe. Une valeur positive décale la première ligne vers la droite, tandis que les lignes suivantes restent alignées avec le corps du paragraphe. Utilisez [IParagraphFormat::set_MarginLeft](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_marginleft/) lorsque vous devez déplacer tout le paragraphe. Utilisez [IParagraphFormat::set_Indent](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_indent/) lorsque vous ne devez déplacer que la première ligne. L’exemple ci‑dessous crée plusieurs paragraphes et applique différentes valeurs `Indent` pour démontrer l’effet de l’indent de première ligne sur la mise en page. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la diapositive cible. 3. Ajoutez une forme rectangulaire [AutoShape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/autoshape/) à la diapositive. 4. Ajoutez un [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/textframe/) vide à la forme et supprimez le paragraphe par défaut. 5. Créez plusieurs paragraphes et définissez des valeurs différentes de [Indent](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_indent/) pour chacun. 6. Ajoutez les paragraphes au cadre de texte. 7. Enregistrez la présentation modifiée. Ce code montre comment définir l’indent d’un paragraphe : ```cpp auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); auto rectangleShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 50, 420, 220); rectangleShape->get_FillFormat()->set_FillType(FillType::NoFill); rectangleShape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid); rectangleShape->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Gray()); auto textFrame = rectangleShape->AddTextFrame(u""); textFrame->get_TextFrameFormat()->set_AutofitType(TextAutofitType::Shape); textFrame->get_Paragraphs()->RemoveAt(0); auto firstParagraph = MakeObject(); firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid); firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black()); firstParagraph->set_Text(u"No first-line indent. Wrapped lines start at the same position as the first line."); firstParagraph->get_ParagraphFormat()->set_MarginLeft(20.f); firstParagraph->get_ParagraphFormat()->set_Indent(0.f); auto secondParagraph = MakeObject(); secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid); secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black()); secondParagraph->set_Text(u"First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."); secondParagraph->get_ParagraphFormat()->set_MarginLeft(20.f); secondParagraph->get_ParagraphFormat()->set_Indent(20.f); auto thirdParagraph = MakeObject(); thirdParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid); thirdParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black()); thirdParagraph->set_Text(u"First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."); thirdParagraph->get_ParagraphFormat()->set_MarginLeft(20.f); thirdParagraph->get_ParagraphFormat()->set_Indent(40.f); textFrame->get_Paragraphs()->Add(firstParagraph); textFrame->get_Paragraphs()->Add(secondParagraph); textFrame->get_Paragraphs()->Add(thirdParagraph); presentation->Save(u"paragraph_indent.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Le résultat : ![The first-line indent of the paragraphs](first_line_indent.png) ## **Définir un retrait suspendu pour un paragraphe** Un retrait suspendu est une mise en page où la première ligne commence à gauche des lignes suivantes. Dans Aspose.Slides, vous créez cet effet avec la méthode [IParagraphFormat::set_Indent](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_indent/). Définissez un retrait négatif pour déplacer la première ligne vers la gauche par rapport au corps du paragraphe. En pratique, [IParagraphFormat::set_MarginLeft](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_marginleft/) définit la position gauche du corps du paragraphe, et [IParagraphFormat::set_Indent](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_indent/) définit la position de la première ligne par rapport à cette marge. Pour créer un retrait suspendu, définissez une valeur positive pour `MarginLeft` et une valeur négative pour `Indent`. Ce formatage est utile pour les bibliographies, références, entrées de glossaire et autres paragraphes où les lignes renvoyées doivent s’aligner sous le corps du paragraphe plutôt que sous le premier caractère de la première ligne. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la diapositive cible. 3. Ajoutez une forme rectangulaire [AutoShape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/autoshape/) à la diapositive. 4. Ajoutez un [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/textframe/) vide à la forme et supprimez le paragraphe par défaut. 5. Créez des paragraphes et définissez une valeur positive de [MarginLeft](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_marginleft/) pour chaque paragraphe. 6. Définissez une valeur négative d’[Indent](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraphformat/set_indent/) pour obtenir l’effet de retrait suspendu. 7. Ajoutez les paragraphes au cadre de texte. 8. Enregistrez la présentation modifiée. Ce code montre comment définir un retrait suspendu pour un paragraphe : ```cpp auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); auto rectangleShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 50, 420, 220); rectangleShape->get_FillFormat()->set_FillType(FillType::NoFill); rectangleShape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid); rectangleShape->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Gray()); auto textFrame = rectangleShape->AddTextFrame(u""); textFrame->get_TextFrameFormat()->set_AutofitType(TextAutofitType::Shape); textFrame->get_Paragraphs()->RemoveAt(0); auto firstParagraph = MakeObject(); firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid); firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black()); firstParagraph->set_Text(u"A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body."); firstParagraph->get_ParagraphFormat()->set_MarginLeft(40.f); firstParagraph->get_ParagraphFormat()->set_Indent(-20.f); auto secondParagraph = MakeObject(); secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid); secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black()); secondParagraph->set_Text(u"This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."); secondParagraph->get_ParagraphFormat()->set_MarginLeft(60.f); secondParagraph->get_ParagraphFormat()->set_Indent(-30.f); textFrame->get_Paragraphs()->Add(firstParagraph); textFrame->get_Paragraphs()->Add(secondParagraph); presentation->Save(u"hanging_indent.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Le résultat : ![The hanging indent of the paragraphs](hanging_indent.png) ## **Gérer les propriétés de fin de paragraphe** 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 1. Obtenez la référence de la diapositive contenant le paragraphe via sa position. 1. Ajoutez un rectangle [autoshape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) à la diapositive. 1. Ajoutez un [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) contenant deux paragraphes au rectangle. 1. Définissez le `FontHeight` et le type de police pour les paragraphes. 1. Définissez les propriétés de fin pour les paragraphes. 1. Écrivez la présentation modifiée au format PPTX. Ce code C++ montre comment définir les propriétés de fin pour les paragraphes dans PowerPoint : ```c++ // Le chemin du répertoire des documents. const String outPath = u"../out/EndParaGraphProperties_out.pptx"; //const String templatePath = u"../templates/DefaultFonts.pptx"; // Charger la présentation souhaitée SharedPtr pres = MakeObject(); // Accéder à la première diapositive SharedPtr sld = pres->get_Slides()->idx_get(0); // Ajouter une AutoShape de type Rectangle SharedPtr ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100, 100, 300, 300); // Ajouter un TextFrame au rectangle SharedPtr tf = ashp->AddTextFrame(String::Empty); // Ajouter le premier paragraphe //SharedPtr para1 = tf->get_Paragraphs()->idx_get(0); SharedPtr para1 = MakeObject(); SharedPtr port01 = MakeObject(u"Sample text"); para1->get_Portions()->Add(port01); // Ajouter le deuxième paragraphe SharedPtr para2 = MakeObject(); SharedPtr port02 = MakeObject(u"Sample text 2"); para2->get_Portions()->Add(port02); SharedPtr endParagraphPortionFormat = MakeObject< PortionFormat>(); endParagraphPortionFormat->set_FontHeight ( 48); endParagraphPortionFormat->set_LatinFont ( MakeObject< FontData>(u"Times New Roman")); para2->set_EndParagraphPortionFormat(endParagraphPortionFormat); ashp->get_TextFrame()->get_Paragraphs()->Add(para1); ashp->get_TextFrame()->get_Paragraphs()->Add(para2); // Enregistrer le PPTX sur le disque pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx); ``` ## **Importer du texte HTML dans des paragraphes** Aspose.Slides offre un support amélioré pour l’importation de texte HTML dans des paragraphes. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/). 2. Accédez à la référence de la diapositive souhaitée via son indice. 3. Ajoutez une [autoshape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iautoshape/) à la diapositive. 4. Ajoutez et accédez à l’[ITextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) de l’autoshape. 5. Supprimez le paragraphe par défaut dans le `ITextFrame`. 6. Lisez le fichier HTML source dans un `TextReader`. 7. Créez la première instance de paragraphe via la classe [Paragraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraph/). 8. Ajoutez le contenu du fichier HTML lu avec le `TextReader` à la [ParagraphCollection](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraphcollection/) du TextFrame. 9. Enregistrez la présentation modifiée. Ce code C++ implémente les étapes d’importation de textes HTML dans des paragraphes : ```c++ For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C // Le chemin du répertoire des documents. const String outPath = u"../out/ImportingHTMLText_out.pptx"; const String sampleHtml = u"../templates/file.html"; // Charger la présentation souhaitée SharedPtr pres = MakeObject(); // Accéder à la première diapositive SharedPtr sld = pres->get_Slides()->idx_get(0); // Ajouter une AutoShape de type Rectangle SharedPtr ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 10, 700, 500); // Réinitialiser la couleur de remplissage par défaut ashp->get_FillFormat()->set_FillType(FillType::NoFill); // Ajouter un TextFrame au rectangle ashp->AddTextFrame(u" "); // Accéder au cadre de texte SharedPtr txtFrame = ashp->get_TextFrame(); //Obtenir la collection de paragraphes SharedPtrParaCollection = txtFrame->get_Paragraphs(); // Effacer tous les paragraphes du cadre de texte ajouté ParaCollection->Clear(); // Charger le fichier HTML à l'aide d'un lecteur de flux SharedPtr tr = MakeObject(sampleHtml); // Ajouter le texte du lecteur de flux HTML au cadre de texte ParaCollection->AddFromHtml(tr->ReadToEnd()); // Créer l'objet Paragraph pour le cadre de texte SharedPtr paragraph = txtFrame->get_Paragraphs()->idx_get(0); // Créer l'objet Portion pour le paragraphe SharedPtr portion = paragraph->get_Portions()->idx_get(0); portion->set_Text(u"Aspose TextBox"); //Obtenir le format de la portion SharedPtr pf = portion->get_PortionFormat(); // Définir la police pour la portion pf->set_LatinFont(MakeObject(u"Times New Roman")); // Définir la propriété gras de la police pf->set_FontBold(NullableBool::True); // Définir la propriété italique de la police pf->set_FontItalic(NullableBool::True); // Définir la propriété soulignement de la police pf->set_FontUnderline(TextUnderlineType::Single); // Définir la taille de la police pf->set_FontHeight(25); // Définir la couleur de la police pf->get_FillFormat()->set_FillType(FillType::Solid); pf->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue()); // Enregistrer le PPTX sur le disque pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx); ``` ## **Exporter le texte d’un paragraphe vers HTML** Aspose.Slides offre un support amélioré pour l’exportation de textes (contenus dans des paragraphes) vers HTML. 1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/cpp/aspose.slides/presentation/) et chargez la présentation souhaitée. 2. Accédez à la référence de la diapositive pertinente via son indice. 3. Accédez à la forme contenant le texte qui sera exporté vers HTML. 4. Accédez au [TextFrame](https://reference.aspose.com/slides/fr/cpp/aspose.slides/itextframe/) de la forme. 5. Créez une instance de `StreamWriter` et ajoutez le nouveau fichier HTML. 6. Fournissez un indice de départ à `StreamWriter` et exportez les paragraphes souhaités. Ce code C++ montre comment exporter les textes de paragraphes PowerPoint vers HTML : ```c++ For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C // Le chemin du répertoire des documents. const String outPath = u"../out/output.html"; const String tempplatePath = u"../templates/DefaultFonts.pptx"; // Charger la présentation souhaitée SharedPtr pres = MakeObject(tempplatePath); // Accéder à la première diapositive par défaut de la présentation SharedPtr slide = pres->get_Slides()->idx_get(0); // Index souhaité int index = 0; // Accéder à la forme ajoutée SharedPtr shape = slide->get_Shapes()->idx_get(0); SharedPtr ashape = DynamicCast(shape); // Extraire le premier paragraphe en HTML SharedPtr sw = MakeObject(outPath, false, Encoding::get_UTF8()); // System::IO::StreamWriter^ sr = gcnew System::IO::StreamWriter("TestFile.txt", false, Encoding::get_UTF8()); //Écrire les données des paragraphes en HTML en fournissant l’indice de départ du paragraphe, le nombre total de paragraphes à copier sw->Write(ashape->get_TextFrame()->get_Paragraphs()->ExportToHtml(0, ashape->get_TextFrame()->get_Paragraphs()->get_Count(), nullptr)); sw->Close(); ``` ## **Enregistrer un paragraphe sous forme d’image** Dans cette section, nous explorerons deux exemples démontrant comment enregistrer un paragraphe de texte, représenté par l’interface [IParagraph](https://reference.aspose.com/slides/fr/cpp/aspose.slides/iparagraph/), sous forme d’image. Les deux exemples incluent l’obtention de l’image d’une forme contenant le paragraphe à l’aide des méthodes `GetImage` de l’interface [IShape](https://reference.aspose.com/slides/fr/cpp/aspose.slides/ishape/), le calcul des limites du paragraphe au sein de la forme, et son exportation en tant qu’image bitmap. Ces approches vous permettent d’extraire des parties spécifiques du texte d’une présentation PowerPoint et de les enregistrer comme images séparées, ce qui peut être utile dans divers scénarios. Supposons que nous ayons un fichier de présentation nommé **sample.pptx** contenant une diapositive, où la première forme est une zone de texte contenant trois paragraphes. ![The text box with three paragraphs](paragraph_to_image_input.png) **Exemple 1** Dans cet exemple, nous obtenons le deuxième paragraphe sous forme d’image. Pour cela, nous extrayons l’image de la forme de la première diapositive de la présentation, puis calculons les limites du deuxième paragraphe dans le cadre de texte de la forme. Le paragraphe est ensuite redessiné sur une nouvelle image bitmap, qui est enregistrée au format PNG. Cette méthode est particulièrement utile lorsque vous devez enregistrer un paragraphe spécifique comme image distincte tout en conservant les dimensions et la mise en forme exactes du texte. ```cpp auto presentation = MakeObject(u"sample.pptx"); auto firstShape = ExplicitCast(presentation->get_Slide(0)->get_Shape(0)); // Save the shape in memory as a bitmap. auto shapeImage = firstShape->GetImage(); auto shapeImageStream = MakeObject(); shapeImage->Save(shapeImageStream, ImageFormat::Png); shapeImage->Dispose(); // Create a shape bitmap from memory. shapeImageStream->set_Position(0); auto shapeBitmap = MakeObject(Image::FromStream(shapeImageStream)); // Calculate the boundaries of the second paragraph. auto secondParagraph = firstShape->get_TextFrame()->get_Paragraph(1); auto paragraphRectangle = secondParagraph->GetRect(); // Calculate the size for the output image (minimum size - 1x1 pixel). auto imageWidth = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Width())); auto imageHeight = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Height())); // Prepare a bitmap for the paragraph. auto paragraphBitmap = MakeObject(imageWidth, imageHeight); // Redraw the paragraph from the shape bitmap to the paragraph bitmap. auto imageGraphics = Graphics::FromImage(paragraphBitmap.get()); RectangleF drawingRectangle(0, 0, paragraphRectangle.get_Width(), paragraphRectangle.get_Height()); imageGraphics->DrawImage(shapeBitmap.get(), drawingRectangle, paragraphRectangle, GraphicsUnit::Pixel); imageGraphics->Dispose(); paragraphBitmap->Save(u"paragraph.png", Imaging::ImageFormat::get_Png()); presentation->Dispose(); ``` Le résultat : ![The paragraph image](paragraph_to_image_output.png) **Exemple 2** Dans cet exemple, nous étendons l’approche précédente en ajoutant des facteurs d’échelle à l’image du paragraphe. La forme est extraite de la présentation et enregistrée sous forme d’image avec un facteur d’échelle de `2`. Cela permet d’obtenir une sortie à plus haute résolution lors de l’exportation du paragraphe. Les limites du paragraphe sont ensuite calculées en tenant compte de l’échelle. Le redimensionnement peut être particulièrement utile lorsqu’une image plus détaillée est nécessaire, par exemple pour des matériaux imprimés de haute qualité. ```cpp auto imageScaleX = 2.0f; auto imageScaleY = imageScaleX; auto presentation = MakeObject(u"sample.pptx"); auto firstShape = ExplicitCast(presentation->get_Slide(0)->get_Shape(0)); // Enregistrer la forme en mémoire sous forme de bitmap avec mise à l'échelle. auto shapeImage = firstShape->GetImage(ShapeThumbnailBounds::Shape, imageScaleX, imageScaleY); auto shapeImageStream = MakeObject(); shapeImage->Save(shapeImageStream, ImageFormat::Png); shapeImage->Dispose(); // Créer un bitmap de forme à partir de la mémoire. shapeImageStream->set_Position(0); auto shapeBitmap = MakeObject(Image::FromStream(shapeImageStream)); // Calculer les limites du deuxième paragraphe. auto secondParagraph = firstShape->get_TextFrame()->get_Paragraph(1); auto paragraphRectangle = secondParagraph->GetRect(); paragraphRectangle.set_X(paragraphRectangle.get_X() * imageScaleX); paragraphRectangle.set_Y(paragraphRectangle.get_Y() * imageScaleY); paragraphRectangle.set_Width(paragraphRectangle.get_Width() * imageScaleX); paragraphRectangle.set_Height(paragraphRectangle.get_Height() * imageScaleY); // Calculer la taille de l'image de sortie (taille minimale - 1x1 pixel). auto imageWidth = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Width())); auto imageHeight = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Height())); // Préparer un bitmap pour le paragraphe. auto paragraphBitmap = MakeObject(imageWidth, imageHeight); // Redessiner le paragraphe du bitmap de forme vers le bitmap du paragraphe. auto imageGraphics = Graphics::FromImage(paragraphBitmap.get()); RectangleF drawingRectangle(0, 0, paragraphRectangle.get_Width(), paragraphRectangle.get_Height()); imageGraphics->DrawImage(shapeBitmap.get(), drawingRectangle, paragraphRectangle, GraphicsUnit::Pixel); imageGraphics->Dispose(); paragraphBitmap->Save(u"paragraph.png", Imaging::ImageFormat::get_Png()); presentation->Dispose(); ``` ## **FAQ** **Puis‑je désactiver totalement le retour à la ligne dans un cadre de texte ?** Oui. Utilisez la méthode de gestion du retour à la ligne du cadre de texte ([set_WrapText](https://reference.aspose.com/slides/fr/cpp/aspose.slides/textframeformat/set_wraptext/)) pour désactiver le retour à la ligne afin que les lignes ne se coupent pas aux bords du cadre. **Comment obtenir les limites exactes sur la diapositive d’un paragraphe spécifique ?** Vous pouvez récupérer le rectangle englobant du paragraphe (et même d’une seule portion) pour connaître sa position et sa taille précises sur la diapositive. **Où est contrôlé l’alignement du paragraphe (gauche/droite/centré/justifié) ?** [Alignment](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraphformat/set_alignment/) est un paramètre au niveau du paragraphe dans [ParagraphFormat](https://reference.aspose.com/slides/fr/cpp/aspose.slides/paragraphformat/); il s’applique à tout le paragraphe indépendamment de la mise en forme des portions individuelles. **Puis‑je définir une langue de vérification orthographique uniquement pour une partie d’un paragraphe (par ex., un mot) ?** Oui. La langue est définie au niveau de la portion en utilisant ([PortionFormat::set_LanguageId](https://reference.aspose.com/slides/fr/cpp/aspose.slides/baseportionformat/set_languageid/)), de sorte que plusieurs langues puissent coexister au sein d’un même paragraphe.