Gérer les Puces

Dans Microsoft PowerPoint, vous pouvez créer des listes à puces et des listes numérotées de la même manière que dans Word et d’autres éditeurs de texte. Aspose.Slides pour 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 l’information rapidement et efficacement.

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 rechercher facilement des points clés
communique et transmet des détails importants efficacement.

Pourquoi Utiliser des Listes Numérotées ?

Les listes numérotées aident également à organiser et à présenter l’information. En général, vous devriez utiliser des numéros (à la place des puces) lorsque l’ordre des éléments (par exemple, étape 1, étape 2, etc.) est important ou lorsque vous devez faire référence à un élément (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éer des Puces ci-dessous :

Créer une instance de la classe de présentation.
Effectuer plusieurs tâches (de l’étape 3 à l’étape 14).
Enregistrer 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 illustrera comment nous pouvons gérer les puces des paragraphes. Les puces sont plus utiles lorsqu’il s’agit de décrire quelque chose en étapes. De plus, le texte semble bien organisé avec l’utilisation de puces. Les paragraphes à puces sont toujours plus faciles à lire et à comprendre. Nous allons voir comment les développeurs peuvent utiliser cette fonctionnalité petite mais puissante d’Aspose.Slides pour Java. Veuillez suivre les étapes ci-dessous pour gérer les puces des paragraphes avec Aspose.Slides pour Java :

Créer une instance de la classe Presentation.
Accéder à la diapositive souhaitée dans la collection de diapositives en utilisant l’objet ISlide.
Ajouter une AutoShape dans la diapositive sélectionnée.
Accéder au TextFrame de la forme ajoutée.
Supprimer le paragraphe par défaut dans le TextFrame.
Créer la première instance de paragraphe en utilisant la classe Paragraph.
Définir le type de puce du paragraphe.
Définir le type de puce sur Symbol et définir le caractère de la puce.
Définir le texte du paragraphe.
Définir l’indentation du paragraphe pour définir la puce.
Définir la couleur de la puce.
Définir la hauteur des puces.
Ajouter le paragraphe créé dans la collection de paragraphes du TextFrame.
Ajouter le deuxième paragraphe et répéter le processus décrit aux étapes 7 à 13.
Enregistrer 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'autoshape créé
    ITextFrame txtFrm = aShp.getTextFrame();
    
    // Supprimer le paragraphe existant par défaut
    txtFrm.getParagraphs().removeAt(0);
    
    // Créer un paragraphe
    Paragraph para = new Paragraph();
    
    // Définir le style et le symbole de la puce
    para.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar((char) 8226);
    
    // Définir le texte du paragraphe
    para.setText("Bienvenue dans Aspose.Slides");
    
    // Définir l'indentation 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 la couleur de puce propre
    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 en tant que fichier PPTX
    pres.save("Bullet.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Créer des Puces d’Image

Aspose.Slides pour Java vous permet de changer les puces des listes à puces. Vous pouvez remplacer les puces par des symboles ou des images personnalisées. Si vous souhaitez ajouter un intérêt visuel à une liste ou attirer encore plus l’attention sur des éléments d’une liste, vous pouvez utiliser votre propre image comme puce.

Idéalement, si vous avez l’intention de remplacer le symbole de puce régulier par une image, vous voudrez peut-être sélectionner une image graphique simple avec un fond transparent. De telles images fonctionnent mieux comme symboles de puce personnalisés.

Dans tous les cas, l’image que vous choisissez sera réduite à une taille très petite, donc nous vous recommandons fortement de sélectionner une image qui a fière allure (comme remplacement du symbole de puce) dans une liste.

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

Créer une instance de la classe Presentation
Accéder à la diapositive souhaitée dans la collection de diapositives en utilisant l’objet ISlide
Ajouter une autoshape dans la diapositive sélectionnée
Accéder au TextFrame de la forme ajoutée
Supprimer le paragraphe par défaut dans le TextFrame
Créer la première instance de paragraphe en utilisant la classe Paragraph
Charger l’image depuis le disque dans IPPImage
Définir le type de puce sur Image et définir l’image
Définir le texte du paragraphe
Définir l’indentation du paragraphe pour définir la puce
Définir la couleur de la puce
Définir la hauteur des puces
Ajouter le paragraphe créé dans la collection de paragraphes du TextFrame
Ajouter le deuxième paragraphe et répéter le processus décrit dans les étapes précédentes
Enregistrer la présentation

Ce code Java vous montre comment créer une puce d’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'autoshape créé
    ITextFrame txtFrm = aShp.getTextFrame();
    // Supprimer le paragraphe existant par défaut
    txtFrm.getParagraphs().removeAt(0);

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

    // Définir le style et l'image de la puce
    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);

    // Écrire la présentation en tant que fichier PPTX
    pres.save("Bullet.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Créer des Puces Multiniveau

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

Créer une instance de la classe Presentation.
Accéder à la diapositive souhaitée dans la collection de diapositives en utilisant l’objet ISlide.
Ajouter une autoshape dans la diapositive sélectionnée.
Accéder au TextFrame de la forme ajoutée.
Supprimer le paragraphe par défaut dans le TextFrame.
Créer la première instance de paragraphe en utilisant la classe Paragraph et en définissant la profondeur à 0.
Créer la deuxième instance de paragraphe en utilisant la classe Paragraph et en définissant la profondeur à 1.
Créer la troisième instance de paragraphe en utilisant la classe Paragraph et en définissant la profondeur à 2.
Créer la quatrième instance de paragraphe en utilisant la classe Paragraph et en définissant la profondeur à 3.
Ajouter les paragraphes créés dans la collection de paragraphes du TextFrame.
Enregistrer la présentation.

Ce code, qui est une 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'autoshape créé
    ITextFrame txtFrm = aShp.addTextFrame("");
    
    // Supprimer le paragraphe existant par défaut
    txtFrm.getParagraphs().clear();
    
    // Créer le premier paragraphe
    Paragraph para1 = new Paragraph();
    // Définir le style et le symbole de la puce
    para1.setText("Contenu");
    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 et le symbole de la puce
    para2.setText("Deuxième niveau");
    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 et le symbole de la puce
    para3.setText("Troisième niveau");
    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 et le symbole de la puce
    para4.setText("Quatrième Niveau");
    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 les Paragraphes au cadre de texte
    txtFrm.getParagraphs().add(para1);
    txtFrm.getParagraphs().add(para2);
    txtFrm.getParagraphs().add(para3);
    txtFrm.getParagraphs().add(para4);
    
    // enregistrer la présentation en tant que fichier PPTX
    pres.save("MultilevelBullet.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Créer une Liste Numérotée Personnalisée

Aspose.Slides pour Java fournit une API simple pour gérer les paragraphes avec un format de numérotation personnalisé. Pour ajouter une liste de numéros personnalisés dans un paragraphe, veuillez suivre les étapes ci-dessous :

Créer une instance de la classe Presentation.
Accéder à la diapositive souhaitée dans la collection de diapositives en utilisant l’objet ISlide.
Ajouter une autoshape dans la diapositive sélectionnée.
Accéder au TextFrame de la forme ajoutée.
Supprimer le paragraphe par défaut dans le TextFrame.
Créer la première instance de paragraphe en utilisant la classe Paragraph et définir NumberedBulletStartWith à 2
Créer la deuxième instance de paragraphe en utilisant la classe Paragraph et définir NumberedBulletStartWith à 3
Créer la troisième instance de paragraphe en utilisant la classe Paragraph et définir NumberedBulletStartWith à 7
Ajouter les paragraphes créés dans la collection de paragraphes du TextFrame.
Enregistrer 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'Autoshape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

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

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

    // Première liste
    Paragraph paragraph1 = new Paragraph();
    paragraph1.setText("puce 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("puce 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("puce 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();
}

Formatage du texte Superscript et Subscript