Gérer les listes à puces et numérotées dans les présentations avec Java

Dans Microsoft PowerPoint, vous pouvez créer des listes à puces et numérotées de la même manière que dans Word et d’autres éditeurs de texte. Aspose.Slides for Java vous permet également d’utiliser des puces et des numéros dans les diapositives de vos présentations.

Pourquoi utiliser des listes à puces ?

Les listes à puces vous aident à organiser et à présenter rapidement et efficacement les informations.

Exemple de liste à puces

Dans la plupart des cas, une liste à puces remplit ces trois fonctions principales :

attire l’attention de vos lecteurs ou spectateurs sur des informations importantes
permet à vos lecteurs ou spectateurs de repérer facilement les points clés
communique et transmet les détails importants de façon efficace.

Pourquoi utiliser des listes numérotées ?

Les listes numérotées aident également à organiser et à présenter les informations. Idéalement, vous devez utiliser des chiffres (à la place des puces) lorsque l’ordre des éléments (par exemple, étape 1, étape 2, etc.) est important ou lorsqu’un élément doit être référencé (par exemple, voir étape 3).

Exemple de liste numérotée

Voici un résumé des étapes (étape 1 à étape 15) de la procédure Création de puces ci‑dessous :

Créez une instance de la classe de présentation.
Effectuez plusieurs tâches (étape 3 à étape 14).
Enregistrez la présentation.

Créer des puces

Ce sujet fait également partie de la série de sujets sur la gestion des paragraphes de texte. Cette page illustre comment gérer les puces de paragraphe. Les puces sont utiles lorsque quelque chose doit être décrit étape par étape. De plus, le texte apparaît bien organisé grâce aux puces. Les paragraphes à puces sont toujours plus faciles à lire et à comprendre. Nous verrons comment les développeurs peuvent exploiter cette petite mais puissante fonctionnalité d’Aspose.Slides for Java. Veuillez suivre les étapes ci‑dessous pour gérer les puces de paragraphe avec Aspose.Slides for Java :

Créez une instance de la classe Presentation.
Accédez à la diapositive souhaitée dans la collection de diapositives à l’aide de l’objet ISlide.
Ajoutez une AutoShape dans la diapositive sélectionnée.
Accédez au TextFrame de la forme ajoutée.
Supprimez le paragraphe par défaut du TextFrame.
Créez la première instance de paragraphe à l’aide de la classe Paragraph.
Définissez le type de puce du paragraphe.
Définissez le type de puce sur Symbol et spécifiez le caractère de puce.
Définissez le texte du paragraphe.
Définissez l’indentation du paragraphe pour placer la puce.
Définissez la couleur de la puce.
Définissez la hauteur des puces.
Ajoutez le paragraphe créé à la collection de paragraphes du TextFrame.
Ajoutez le second paragraphe et répétez le processus indiqué aux étapes 7 à 13.
Enregistrez la présentation.

Ce code d’exemple en Java — une implémentation des étapes ci‑dessus—vous montre comment créer une liste à puces dans une diapositive :

// Instancier une classe Presentation qui représente un fichier PPTX
Presentation pres = new Presentation();
try {
    // Accéder à la première diapositive
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Ajouter et accéder à l'AutoShape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    
    // Accéder au cadre de texte de l'auto‑shape créé
    ITextFrame txtFrm = aShp.getTextFrame();
    
    // Supprimer le paragraphe par défaut existant
    txtFrm.getParagraphs().removeAt(0);
    
    // Créer un paragraphe
    Paragraph para = new Paragraph();
    
    // Définir le style de puce du paragraphe et le symbole
    para.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar((char) 8226);
    
    // Définir le texte du paragraphe
    para.setText("Welcome to Aspose.Slides");
    
    // Définir le retrait de la puce
    para.getParagraphFormat().setIndent(25);
    
    // Définir la couleur de la puce
    para.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    
    // définir IsBulletHardColor à true pour utiliser sa propre couleur de puce
    para.getParagraphFormat().getBullet().isBulletHardColor();
    
    // Définir la hauteur de la puce
    para.getParagraphFormat().getBullet().setHeight(100);
    
    // Ajouter le paragraphe au cadre de texte
    txtFrm.getParagraphs().add(para);
    
    // Enregistrer la présentation sous forme de fichier PPTX
    pres.save("Bullet.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Créer des puces image

Aspose.Slides for Java vous permet de modifier les puces des listes à puces. Vous pouvez remplacer les puces par des symboles ou des images personnalisés. Si vous souhaitez ajouter un aspect visuel à une liste ou attirer davantage l’attention sur certains éléments, vous pouvez utiliser votre propre image comme puce.

Idéalement, si vous avez l’intention de remplacer le symbole de puce standard par une image, choisissez une simple illustration avec un arrière‑plan transparent. Ces images fonctionnent le mieux comme symboles de puce personnalisés.

Dans tous les cas, l’image choisie sera réduite à une taille très petite ; nous vous recommandons donc de sélectionner une image qui reste lisible (en tant que substitution du symbole de puce) dans une liste.

Pour créer une puce image, suivez ces étapes :

Créez une instance de la classe Presentation
Accédez à la diapositive souhaitée dans la collection de diapositives à l’aide de l’objet ISlide
Ajoutez une forme auto‑shape dans la diapositive sélectionnée
Accédez au TextFrame de la forme ajoutée
Supprimez le paragraphe par défaut du TextFrame
Créez la première instance de paragraphe à l’aide de la classe Paragraph
Chargez l’image depuis le disque dans IPPImage
Définissez le type de puce sur Picture et spécifiez l’image
Définissez le texte du paragraphe
Définissez l’indentation du paragraphe pour placer la puce
Définissez la couleur de la puce
Définissez la hauteur des puces
Ajoutez le paragraphe créé à la collection de paragraphes du TextFrame
Ajoutez le second paragraphe et répétez le processus indiqué aux étapes précédentes
Enregistrez la présentation

Ce code Java vous montre comment créer une puce image dans une diapositive :

Presentation pres = new Presentation();
try {
    // Accéder à la première diapositive
    ISlide slide = pres.getSlides().get_Item(0);

    // Instancier l'image pour les puces
    IPPImage picture;
    IImage image = Images.fromFile("asp1.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Ajouter et accéder à l'AutoShape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accéder au cadre de texte de l'auto‑shape créé
    ITextFrame txtFrm = aShp.getTextFrame();
    // Supprimer le paragraphe par défaut existant
    txtFrm.getParagraphs().removeAt(0);

    // Créer un nouveau paragraphe
    Paragraph para = new Paragraph();
    para.setText("Welcome to Aspose.Slides");

    // Définir le style de puce du paragraphe et l'image
    para.getParagraphFormat().getBullet().setType(BulletType.Picture);
    para.getParagraphFormat().getBullet().getPicture().setImage(picture);

    // Définir la hauteur de la puce
    para.getParagraphFormat().getBullet().setHeight(100);

    // Ajouter le paragraphe au cadre de texte
    txtFrm.getParagraphs().add(para);

    // Enregistrer la présentation sous forme de fichier PPTX
    pres.save("Bullet.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Créer des puces multiniveaux

Pour créer une liste à puces contenant des éléments à différents niveaux — des listes supplémentaires sous la liste principale — suivez ces étapes :

Créez une instance de la classe Presentation.
Accédez à la diapositive souhaitée dans la collection de diapositives à l’aide de l’objet ISlide.
Ajoutez une forme auto‑shape dans la diapositive sélectionnée.
Accédez au TextFrame de la forme ajoutée.
Supprimez le paragraphe par défaut du TextFrame.
Créez la première instance de paragraphe à l’aide de la classe Paragraph avec une profondeur = 0.
Créez la seconde instance de paragraphe à l’aide de la classe Paragraph avec une profondeur = 1.
Créez la troisième instance de paragraphe à l’aide de la classe Paragraph avec une profondeur = 2.
Créez la quatrième instance de paragraphe à l’aide de la classe Paragraph avec une profondeur = 3.
Ajoutez les paragraphes créés à la collection de paragraphes du TextFrame.
Enregistrez la présentation.

Ce code, implémentation des étapes ci‑dessus, vous montre comment créer une liste à puces multiniveau en Java :

// Instancier une classe Presentation qui représente un fichier PPTX
Presentation pres = new Presentation();
try {
    // Accéder à la première diapositive
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Ajouter et accéder à l'AutoShape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    
    // Accéder au cadre de texte de l'auto‑shape créé
    ITextFrame txtFrm = aShp.addTextFrame("");
    
    // Supprimer le paragraphe par défaut existant
    txtFrm.getParagraphs().clear();
    
    // Créer le premier paragraphe
    Paragraph para1 = new Paragraph();
    // Définir le style de puce du paragraphe et le symbole
    para1.setText("Content");
    para1.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para1.getParagraphFormat().getBullet().setChar((char) 8226);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType ((byte)FillType.Solid);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    //Définir le niveau de la puce
    para1.getParagraphFormat().setDepth ((short)0);
    
    // Créer le deuxième paragraphe
    Paragraph para2 = new Paragraph();
    // Définir le style de puce du paragraphe et le symbole
    para2.setText("Second level");
    para2.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para2.getParagraphFormat().getBullet().setChar('-');
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType ((byte)FillType.Solid);
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    //Définir le niveau de la puce
    para2.getParagraphFormat().setDepth ((short)1);
    
    // Créer le troisième paragraphe
    Paragraph para3 = new Paragraph();
    // Définir le style de puce du paragraphe et le symbole
    para3.setText("Third level");
    para3.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para3.getParagraphFormat().getBullet().setChar((char) 8226);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType ((byte)FillType.Solid);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    //Définir le niveau de la puce
    para3.getParagraphFormat().setDepth ((short)2);
    
    // Créer le quatrième paragraphe
    Paragraph para4 = new Paragraph();
    // Définir le style de puce du paragraphe et le symbole
    para4.setText("Fourth Level");
    para4.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para4.getParagraphFormat().getBullet().setChar('-');
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType ((byte)FillType.Solid);
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    //Définir le niveau de la puce
    para4.getParagraphFormat().setDepth ((short)3);
    
    // Ajouter le paragraphe au cadre de texte
    txtFrm.getParagraphs().add(para1);
    txtFrm.getParagraphs().add(para2);
    txtFrm.getParagraphs().add(para3);
    txtFrm.getParagraphs().add(para4);
    
    // Enregistrer la présentation sous forme de fichier PPTX
    pres.save("MultilevelBullet.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Créer des listes numérotées personnalisées

Aspose.Slides for Java offre une API simple pour gérer les paragraphes avec un format de numérotation personnalisé. Pour ajouter une liste numérotée personnalisée dans un paragraphe, suivez les étapes ci‑dessous :

Créez une instance de la classe Presentation.
Accédez à la diapositive souhaitée dans la collection de diapositives à l’aide de l’objet ISlide.
Ajoutez une forme auto‑shape dans la diapositive sélectionnée.
Accédez au TextFrame de la forme ajoutée.
Supprimez le paragraphe par défaut du TextFrame.
Créez la première instance de paragraphe à l’aide de la classe Paragraph et définissez NumberedBulletStartWith à 2
Créez la seconde instance de paragraphe à l’aide de la classe Paragraph et définissez NumberedBulletStartWith à 3
Créez la troisième instance de paragraphe à l’aide de la classe Paragraph et définissez NumberedBulletStartWith à 7
Ajoutez les paragraphes créés à la collection de paragraphes du TextFrame.
Enregistrez la présentation.

Ce code Java vous montre comment créer une liste numérotée dans une diapositive :

// Instancier une classe Presentation qui représente un fichier PPTX
Presentation pres = new Presentation();
try {
    // Accéder à la première diapositive
    ISlide slide = pres.getSlides().get_Item(0);

    // Ajouter et accéder à l'auto shape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accéder au cadre de texte de l'auto shape créé
    ITextFrame txtFrm = aShp.addTextFrame("");

    // Supprimer le paragraphe par défaut existant
    txtFrm.getParagraphs().clear();

    // Première liste
    Paragraph paragraph1 = new Paragraph();
    paragraph1.setText("bullet 2");
    paragraph1.getParagraphFormat().setDepth((short)4);
    paragraph1.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)2);
    paragraph1.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    txtFrm.getParagraphs().add(paragraph1);

    Paragraph paragraph2 = new Paragraph();
    paragraph2.setText("bullet 3");
    paragraph2.getParagraphFormat().setDepth((short)4);
    paragraph2.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)3);
    paragraph2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    txtFrm.getParagraphs().add(paragraph2);

    // Deuxième liste
    Paragraph paragraph5 = new Paragraph();
    paragraph5.setText("bullet 5");
    paragraph5.getParagraphFormat().setDepth((short)4);
    paragraph5.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)5);
    paragraph5.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    txtFrm.getParagraphs().add(paragraph5);

    pres.save(resourcesOutputPath + "SetCustomBulletsNumber-slides.pptx.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Les listes à puces et numérotées créées avec Aspose.Slides peuvent‑elles être exportées vers d’autres formats tels que PDF ou images ?

Oui, Aspose.Slides conserve intégralement le formatage et la structure des listes à puces et numérotées lors de l’exportation des présentations vers des formats comme PDF, images et d’autres, garantissant des résultats cohérents.

Est‑il possible d’importer des listes à puces ou numérotées à partir de présentations existantes ?

Oui, Aspose.Slides permet d’importer et de modifier des listes à puces ou numérotées provenant de présentations existantes tout en préservant leur formatage et leur apparence d’origine.

Aspose.Slides prend‑il en charge les listes à puces et numérotées dans des présentations créées dans plusieurs langues ?

Oui, Aspose.Slides prend entièrement en charge les présentations multilingues, vous permettant de créer des listes à puces et numérotées dans n’importe quelle langue, y compris l’utilisation de caractères spéciaux ou non latins.

Formater le texte PowerPoint en Java Gérer les exposants et les indices dans les présentations avec Java