Administrar Viñetas

En Microsoft PowerPoint, puedes crear listas con viñetas y listas numeradas de la misma manera que lo haces en Word y otros editores de texto. Aspose.Slides para Java también te permite usar viñetas y números en las diapositivas de tus presentaciones.

¿Por qué usar listas con viñetas?

Las listas con viñetas te ayudan a organizar y presentar información de manera rápida y eficiente.

Ejemplo de lista con viñetas

En la mayoría de los casos, una lista con viñetas cumple estas tres funciones principales:

llama la atención de tus lectores o espectadores hacia información importante
permite que tus lectores o espectadores escaneen fácilmente los puntos clave
comunica y entrega detalles importantes de manera eficiente.

¿Por qué usar listas numeradas?

Las listas numeradas también ayudan en la organización y presentación de información. Idealmente, debes usar números (en lugar de viñetas) cuando el orden de las entradas (por ejemplo, paso 1, paso 2, etc.) es importante o cuando una entrada tiene que ser referenciada (por ejemplo, ver paso 3).

Ejemplo de lista numerada

Este es un resumen de los pasos (paso 1 a paso 15) en el procedimiento de Crear Viñetas a continuación:

Crea una instancia de la clase presentación.
Realiza varias tareas (paso 3 a paso 14).
Guarda la presentación.

Crear Viñetas

Este tema también forma parte de la serie de temas sobre la gestión de párrafos de texto. Esta página ilustrará cómo podemos gestionar las viñetas de los párrafos. Las viñetas son más útiles donde algo debe describirse en pasos. Además, el texto se ve bien organizado con el uso de viñetas. Los párrafos con viñetas son siempre más fáciles de leer y entender. Veremos cómo los desarrolladores pueden utilizar esta pequeña pero poderosa característica de Aspose.Slides para Java. Por favor, sigue los pasos a continuación para gestionar las viñetas de los párrafos usando Aspose.Slides para Java:

Crea una instancia de la clase Presentation.
Accede a la diapositiva deseada en la colección de diapositivas usando el objeto ISlide.
Agrega una AutoShape en la diapositiva seleccionada.
Accede al TextFrame de la forma añadida.
Elimina el párrafo predeterminado en el TextFrame.
Crea la primera instancia de párrafo usando la clase Paragraph.
Establece el tipo de viñeta del párrafo.
Establece el tipo de viñeta en Symbol y configura el carácter de la viñeta.
Establece el Texto del Párrafo.
Establece la Sangría del Párrafo para configurar la viñeta.
Establece el Color de la Viñeta.
Establece la Altura de las Viñetas.
Agrega el párrafo creado en la colección de párrafos del TextFrame.
Agrega el segundo párrafo y repite el proceso indicado en los pasos 7 a 13.
Guarda la presentación.

Este código de ejemplo en Java—una implementación de los pasos anteriores—te muestra cómo crear una lista con viñetas en una diapositiva:

// Instanciar una clase Presentation que representa un archivo PPTX
Presentation pres = new Presentation();
try {
    // Accediendo a la primera diapositiva
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Agregando y accediendo a la Autoshape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    
    // Accediendo al marco de texto de la autoshape creada
    ITextFrame txtFrm = aShp.getTextFrame();
    
    // Eliminando el párrafo predeterminado existente
    txtFrm.getParagraphs().removeAt(0);
    
    // Creando un párrafo
    Paragraph para = new Paragraph();
    
    // Estableciendo el estilo de viñeta del párrafo y el símbolo
    para.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar((char) 8226);
    
    // Estableciendo el texto del párrafo
    para.setText("Bienvenido a Aspose.Slides");
    
    // Estableciendo la sangría del párrafo
    para.getParagraphFormat().setIndent(25);
    
    // Estableciendo el color de la viñeta
    para.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    
    // establecer IsBulletHardColor en true para usar el color de viñeta propio
    para.getParagraphFormat().getBullet().isBulletHardColor();
    
    // Estableciendo la altura de la viñeta
    para.getParagraphFormat().getBullet().setHeight(100);
    
    // Agregando el párrafo al marco de texto
    txtFrm.getParagraphs().add(para);
    
    // guardando la presentación como un archivo PPTX
    pres.save("Bullet.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Crear Viñetas de Imágenes

Aspose.Slides para Java te permite cambiar las viñetas en las listas de viñetas. Puedes reemplazar las viñetas con símbolos o imágenes personalizadas. Si deseas agregar interés visual a una lista o llamar aún más la atención a las entradas de una lista, puedes utilizar tu propia imagen como viñeta.

Idealmente, si tienes la intención de reemplazar el símbolo de viñeta regular con una imagen, es posible que desees seleccionar una imagen gráfica simple con un fondo transparente. Tales imágenes funcionan mejor como símbolos de viñetas personalizados.

En cualquier caso, la imagen que elijas se reducirá a un tamaño muy pequeño, por lo que te recomendamos encarecidamente seleccionar una imagen que se vea bien (como reemplazo del símbolo de viñeta) en una lista.

Para crear una viñeta de imagen, sigue estos pasos:

Crea una instancia de la clase Presentation
Accede a la diapositiva deseada en la colección de diapositivas usando el objeto ISlide
Agrega una autoshape en la diapositiva seleccionada
Accede al TextFrame de la forma añadida
Elimina el párrafo predeterminado en el TextFrame
Crea la primera instancia de párrafo usando la clase Paragraph
Carga la imagen del disco en IPPImage
Establece el tipo de viñeta a Picture y configura la imagen
Establece el texto del párrafo
Establece la sangría del párrafo para configurar la viñeta
Establece el color de la viñeta
Establece la altura de las viñetas
Agrega el párrafo creado en la colección de párrafos del TextFrame
Agrega el segundo párrafo y repite el proceso indicado en los pasos anteriores
Guarda la presentación

Este código en Java muestra cómo crear una viñeta de imagen en una diapositiva:

Presentation pres = new Presentation();
try {
    // Accediendo a la primera diapositiva
    ISlide slide = pres.getSlides().get_Item(0);

    // Instanciando la imagen para las viñetas
    IPPImage picture;
    IImage image = Images.fromFile("asp1.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Agregando y accediendo a la Autoshape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accediendo al marco de texto de la autoshape creada
    ITextFrame txtFrm = aShp.getTextFrame();
    // Eliminando el párrafo predeterminado existente
    txtFrm.getParagraphs().removeAt(0);

    // Creando un nuevo párrafo
    Paragraph para = new Paragraph();
    para.setText("Bienvenido a Aspose.Slides");

    // Estableciendo el estilo de viñeta del párrafo y la imagen
    para.getParagraphFormat().getBullet().setType(BulletType.Picture);
    para.getParagraphFormat().getBullet().getPicture().setImage(picture);

    // Estableciendo la altura de la viñeta
    para.getParagraphFormat().getBullet().setHeight(100);

    // Agregando el párrafo al marco de texto
    txtFrm.getParagraphs().add(para);

    // Escribiendo la presentación como un archivo PPTX
    pres.save("Bullet.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Crear Viñetas Multinivel

Para crear una lista con viñetas que contenga elementos en diferentes niveles—listas adicionales bajo la lista de viñetas principal—sigue estos pasos:

Crea una instancia de la clase Presentation.
Accede a la diapositiva deseada en la colección de diapositivas usando el objeto ISlide.
Agrega una autoshape en la diapositiva seleccionada.
Accede al TextFrame de la forma añadida.
Elimina el párrafo predeterminado en el TextFrame.
Crea la primera instancia de párrafo usando la clase Paragraph y estableciendo la profundidad en 0.
Crea la segunda instancia de párrafo usando la clase Paragraph y estableciendo la profundidad en 1.
Crea la tercera instancia de párrafo usando la clase Paragraph y estableciendo la profundidad en 2.
Crea la cuarta instancia de párrafo usando la clase Paragraph y estableciendo la profundidad en 3.
Agrega los párrafos creados en la colección de párrafos del TextFrame.
Guarda la presentación.

Este código, que es una implementación de los pasos anteriores, te muestra cómo crear una lista con viñetas multinivel en Java:

// Instanciar una clase Presentation que representa un archivo PPTX
Presentation pres = new Presentation();
try {
    // Accediendo a la primera diapositiva
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Agregando y accediendo a la Autoshape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    
    // Accediendo al marco de texto de la autoshape creada
    ITextFrame txtFrm = aShp.addTextFrame("");
    
    // Eliminando el párrafo predeterminado existente
    txtFrm.getParagraphs().clear();
    
    // Creando el primer párrafo
    Paragraph para1 = new Paragraph();
    // Estableciendo el estilo de viñeta del párrafo y símbolo
    para1.setText("Contenido");
    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);
    //Estableciendo el nivel de la viñeta
    para1.getParagraphFormat().setDepth ((short)0);
    
    // Creando el segundo párrafo
    Paragraph para2 = new Paragraph();
    // Estableciendo el estilo de viñeta del párrafo y símbolo
    para2.setText("Segundo nivel");
    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);
    //Estableciendo el nivel de la viñeta
    para2.getParagraphFormat().setDepth ((short)1);
    
    // Creando el tercer párrafo
    Paragraph para3 = new Paragraph();
    // Estableciendo el estilo de viñeta del párrafo y símbolo
    para3.setText("Tercer nivel");
    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);
    //Estableciendo el nivel de la viñeta
    para3.getParagraphFormat().setDepth ((short)2);
    
    // Creando el cuarto párrafo
    Paragraph para4 = new Paragraph();
    // Estableciendo el estilo de viñeta del párrafo y símbolo
    para4.setText("Cuarto Nivel");
    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);
    //Estableciendo el nivel de la viñeta
    para4.getParagraphFormat().setDepth ((short)3);
    
    // Agregando los párrafos al marco de texto
    txtFrm.getParagraphs().add(para1);
    txtFrm.getParagraphs().add(para2);
    txtFrm.getParagraphs().add(para3);
    txtFrm.getParagraphs().add(para4);
    
    // guardando la presentación como un archivo PPTX
    pres.save("MultilevelBullet.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Crear Lista Numerada Personalizada

Aspose.Slides para Java proporciona una API sencilla para gestionar párrafos con formato de números personalizados. Para agregar una lista numerada personalizada en un párrafo, sigue los pasos a continuación:

Crea una instancia de la clase Presentation.
Accede a la diapositiva deseada en la colección de diapositivas usando el objeto ISlide.
Agrega una autoshape en la diapositiva seleccionada.
Accede al TextFrame de la forma añadida.
Elimina el párrafo predeterminado en el TextFrame.
Crea la primera instancia de párrafo usando la clase Paragraph y establece NumberedBulletStartWith en 2
Crea la segunda instancia de párrafo usando la clase Paragraph y establece NumberedBulletStartWith en 3
Crea la tercera instancia de párrafo usando la clase Paragraph y establece NumberedBulletStartWith en 7
Agrega los párrafos creados en la colección de párrafos del TextFrame.
Guarda la presentación.

Este código en Java muestra cómo crear una lista numerada en una diapositiva:

// Instanciar una clase Presentation que representa un archivo PPTX
Presentation pres = new Presentation();
try {
    // Accediendo a la primera diapositiva
    ISlide slide = pres.getSlides().get_Item(0);

    // Agregando y accediendo a la Autoshape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accediendo al marco de texto de la autoshape creada
    ITextFrame txtFrm = aShp.addTextFrame("");

    // Eliminando el párrafo predeterminado existente
    txtFrm.getParagraphs().clear();

    // Primera lista
    Paragraph paragraph1 = new Paragraph();
    paragraph1.setText("viñeta 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("viñeta 3");
    paragraph2.getParagraphFormat().setDepth((short)4);
    paragraph2.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)3);
    paragraph2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    txtFrm.getParagraphs().add(paragraph2);

    // Segunda lista
    Paragraph paragraph5 = new Paragraph();
    paragraph5.setText("viñeta 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();
}

Formateo de Texto Superíndices y Subíndices