Administrar Listas con Viñetas y Numeradas

En Microsoft PowerPoint, puedes crear listas con viñetas y numeradas de la misma manera que lo haces en Word y otros editores de texto. Aspose.Slides for .NET 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 sobre información importante
permite a tus lectores o espectadores escanear fácilmente los puntos clave
comunica y entrega detalles importantes de manera eficiente.

¿Por qué usar listas numeradas?

Las listas numeradas también ayudan a organizar y presentar información. Idealmente, deberías 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 se debe hacer referencia a una entrada (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 Creación de Viñetas a continuación:

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

Creando Viñetas

Para crear una lista con viñetas, sigue estos pasos:

Crea una instancia de la clase Presentation.
Accede a la diapositiva (en la que deseas agregar una lista con viñetas) en la colección de diapositivas a través del objeto ISlide.
Agrega una AutoShape en la diapositiva seleccionada.
Accede al TextFrame de la forma agregada.
Elimina el párrafo predeterminado en el TextFrame.
Crea la primera instancia de párrafo utilizando la clase Paragraph.
Establece el tipo de viñeta como Símbolo y luego establece 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 la viñeta.
Agrega el párrafo creado a la colección de párrafos del TextFrame.
Agrega el segundo párrafo y repite los pasos 7-12.
Guarda la presentación.

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

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    paragraph.ParagraphFormat.Bullet.Char = '*';
    paragraph.ParagraphFormat.Indent = 15;
    paragraph.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True;
    paragraph.ParagraphFormat.Bullet.Color.Color = Color.Red;
    paragraph.ParagraphFormat.Bullet.Height = 100;
    paragraph.Text = "Mi texto";

    textFrame.Paragraphs.Add(paragraph);
    
    // ...
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

Creando Viñetas de Imagen

Aspose.Slides for .NET te permite cambiar las viñetas en listas con 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 usar tu propia imagen como viñeta.

Idealmente, si tienes intención de reemplazar el símbolo de viñeta regular por una imagen, querrás seleccionar una imagen gráfica simple con un fondo transparente. Tales imágenes funcionan mejor como símbolos de viñeta 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 utilizando el objeto ISlide.
Agrega una AutoShape en la diapositiva seleccionada.
Accede al TextFrame de la forma agregada.
Elimina el párrafo predeterminado en el TextFrame.
Crea la primera instancia de párrafo utilizando la clase Paragraph.
Carga la imagen desde el disco y agrégala a Presentation.Images y luego utiliza la instancia IPPImage que se devolvió desde el método AddImage.
Establece el tipo de viñeta como Imagen y luego establece 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 a la colección de párrafos del TextFrame.
Agrega el segundo párrafo y repite los pasos 7-13.
Guarda la presentación.

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

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Picture;
    IPPImage image = pres.Images.AddImage(File.ReadAllBytes("image.png"));
    paragraph.ParagraphFormat.Bullet.Picture.Image = image;
    paragraph.ParagraphFormat.Indent = 15;
    paragraph.ParagraphFormat.Bullet.Height = 100;
    paragraph.Text = "Mi texto";

    textFrame.Paragraphs.Add(paragraph);
    
    // ...
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

Creando Viñetas Multinivel

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

Crea una instancia de la clase Presentation.
Accede a la diapositiva deseada en la colección de diapositivas utilizando el objeto ISlide.
Agrega una AutoShape en la diapositiva seleccionada.
Accede al TextFrame de la forma agregada.
Elimina el párrafo predeterminado en el TextFrame.
Crea la primera instancia de párrafo utilizando la clase Paragraph y con la profundidad establecida en 0.
Crea la segunda instancia de párrafo utilizando la clase Paragraph y la profundidad establecida en 1.
Crea la tercera instancia de párrafo utilizando la clase Paragraph y la profundidad establecida en 2.
Crea la cuarta instancia de párrafo utilizando la clase Paragraph y la profundidad establecida en 3.
Agrega los párrafos creados a 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 C#:

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 300, 300);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Depth = 0;
    paragraph.Text = "Mi texto Profundidad 0";
    textFrame.Paragraphs.Add(paragraph);
    
    Paragraph paragraph2 = new Paragraph();
    paragraph2.ParagraphFormat.Depth = 0;
    paragraph2.Text = "Mi texto Profundidad 1";
    textFrame.Paragraphs.Add(paragraph2);
    
    Paragraph paragraph3 = new Paragraph();
    paragraph3.ParagraphFormat.Depth = 2;
    paragraph3.Text = "Mi texto Profundidad 2";
    textFrame.Paragraphs.Add(paragraph3);
    
    Paragraph paragraph4 = new Paragraph();
    paragraph4.ParagraphFormat.Depth = 3;
    paragraph4.Text = "Mi texto Profundidad 3";
    textFrame.Paragraphs.Add(paragraph4);
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

Creando Números

Este código C# te muestra cómo crear una lista numerada en una diapositiva:

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Paragraphs.Clear();
    
    Paragraph paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    paragraph.Text = "Mi texto 1";
    textFrame.Paragraphs.Add(paragraph);
    
    Paragraph paragraph2 = new Paragraph();
    paragraph2.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    paragraph2.Text = "Mi texto 2";
    textFrame.Paragraphs.Add(paragraph2);
    
    // ...
    
    pres.Save("pres.pptx", SaveFormat.Pptx);
}

Texto Animado Superíndice y Subíndice