Gestionar listas con viñetas y numeradas en presentaciones usando PHP

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

¿Por qué usar listas de viñetas?

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

Ejemplo de lista de viñetas

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

atrae la atención de tus lectores o espectadores a la información importante
permite a tus lectores o espectadores escanear fácilmente los puntos clave
comunica y entrega los 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 los elementos (por ejemplo, paso 1, paso 2, etc.) sea importante o cuando un elemento deba ser referenciado (por ejemplo, ver paso 3).

Ejemplo de lista numerada

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

Crear una instancia de la clase Presentation.
Ejecutar varias tareas (del paso 3 al paso 14).
Guardar 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 viñetas de párrafo. Las viñetas son más útiles cuando algo debe describirse en pasos. Además, el texto parece bien organizado con el uso de viñetas. Los párrafos con viñetas siempre son más fáciles de leer y entender. Veremos cómo los desarrolladores pueden usar esta característica pequeña pero potente de Aspose.Slides for PHP via Java. Por favor, sigue los pasos a continuación para gestionar las viñetas de párrafo usando Aspose.Slides for PHP via Java:

Crear una instancia de la clase Presentation.
Acceder a la diapositiva deseada en la colección de diapositivas usando el objeto Slide.
Añadir un AutoShape en la diapositiva seleccionada.
Acceder al TextFrame de la forma añadida.
Eliminar el párrafo predeterminado en el TextFrame.
Crear la primera instancia de párrafo usando la clase Paragraph.
Establecer el tipo de viñeta del párrafo.
Establecer el tipo de viñeta a Symbol y establecer el carácter de viñeta.
Establecer el texto del párrafo.
Establecer la sangría del párrafo para definir la viñeta.
Establecer el color de la viñeta.
Establecer la altura de las viñetas.
Añadir el párrafo creado a la colección de párrafos del TextFrame.
Añadir el segundo párrafo y repetir el proceso indicado en los pasos 7 a 13.
Guardar la presentación.

  # Instanciar una clase Presentation que representa un archivo PPTX
  $pres = new Presentation();
  try {
    # Accediendo a la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Añadiendo y accediendo al Autoshape
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Accediendo al marco de texto del autoshape creado
    $txtFrm = $aShp->getTextFrame();
    # Eliminando el párrafo predeterminado existente
    $txtFrm->getParagraphs()->removeAt(0);
    # Creando un párrafo
    $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(8226);
    # Estableciendo el texto del párrafo
    $para->setText("Welcome to Aspose.Slides");
    # Estableciendo la sangría de la viñeta
    $para->getParagraphFormat()->setIndent(25);
    # Estableciendo el color de la viñeta
    $para->getParagraphFormat()->getBullet()->getColor()->setColorType(ColorType::RGB);
    $para->getParagraphFormat()->getBullet()->getColor()->setColor(java("java.awt.Color")->BLACK);
    # Establecer IsBulletHardColor a true para usar un color propio de la viñeta
    $para->getParagraphFormat()->getBullet()->isBulletHardColor();
    # Estableciendo la altura de la viñeta
    $para->getParagraphFormat()->getBullet()->setHeight(100);
    # Añadiendo 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 con imágenes

Aspose.Slides for PHP via Java permite cambiar las viñetas en las listas de viñetas. Puedes sustituir las viñetas por símbolos o imágenes personalizados. Si deseas añadir interés visual a una lista o atraer aún más la atención a los elementos de una lista, puedes usar tu propia imagen como viñeta.

Idealmente, si tienes la intención de reemplazar el símbolo de viñeta normal por una imagen, deberías seleccionar una imagen gráfica simple con fondo transparente. Este tipo de imágenes funciona 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 recomendamos encarecidamente que selecciones una imagen que se vea bien (como sustituto del símbolo de viñeta) en una lista.

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

Crear una instancia de la clase Presentation
Acceder a la diapositiva deseada en la colección de diapositivas usando el objeto Slide
Añadir un autoshape en la diapositiva seleccionada
Acceder al TextFrame de la forma añadida
Eliminar el párrafo predeterminado en el TextFrame
Crear la primera instancia de párrafo usando la clase Paragraph
Cargar la imagen desde disco en PPImage
Establecer el tipo de viñeta a Picture y asignar la imagen
Establecer el texto del párrafo
Establecer la sangría del párrafo para definir la viñeta
Establecer el color de la viñeta
Establecer la altura de las viñetas
Añadir el párrafo creado a la colección de párrafos del TextFrame
Añadir el segundo párrafo y repetir el proceso indicado en los pasos anteriores
Guardar la presentación

  $pres = new Presentation();
  try {
    # Accediendo a la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Instanciar la imagen para viñetas
    $picture;
    $image = Images->fromFile("asp1.jpg");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # Añadiendo y accediendo al Autoshape
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Accediendo al marco de texto del autoshape creado
    $txtFrm = $aShp->getTextFrame();
    # Eliminando el párrafo predeterminado existente
    $txtFrm->getParagraphs()->removeAt(0);
    # Creando nuevo párrafo
    $para = new Paragraph();
    $para->setText("Welcome to Aspose.Slides");
    # Configurando el estilo de viñeta del párrafo y la imagen
    $para->getParagraphFormat()->getBullet()->setType(BulletType::Picture);
    $para->getParagraphFormat()->getBullet()->getPicture()->setImage($picture);
    # Configurando la altura de la viñeta
    $para->getParagraphFormat()->getBullet()->setHeight(100);
    # Añadiendo el párrafo al marco de texto
    $txtFrm->getParagraphs()->add($para);
    # Guardando la presentación como archivo PPTX
    $pres->save("Bullet.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Crear viñetas multinivel

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

Crear una instancia de la clase Presentation.
Acceder a la diapositiva deseada en la colección de diapositivas usando el objeto Slide.
Añadir un autoshape en la diapositiva seleccionada.
Acceder al TextFrame de la forma añadida.
Eliminar el párrafo predeterminado en el TextFrame.
Crear la primera instancia de párrafo usando la clase Paragraph y con profundidad establecida en 0.
Crear la segunda instancia de párrafo usando la clase Paragraph y con profundidad establecida en 1.
Crear la tercera instancia de párrafo usando la clase Paragraph y con profundidad establecida en 2.
Crear la cuarta instancia de párrafo usando la clase Paragraph y con profundidad establecida en 3.
Añadir los párrafos creados a la colección de párrafos del TextFrame.
Guardar la presentación.

  # Instanciar una clase Presentation que representa un archivo PPTX
  $pres = new Presentation();
  try {
    # Accediendo a la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Añadiendo y accediendo al Autoshape
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Accediendo al marco de texto del autoshape creado
    $txtFrm = $aShp->addTextFrame("");
    # Eliminando el párrafo predeterminado existente
    $txtFrm->getParagraphs()->clear();
    # Creando el primer párrafo
    $para1 = new Paragraph();
    # Estableciendo el estilo de viñeta del párrafo y el símbolo
    $para1->setText("Content");
    $para1->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para1->getParagraphFormat()->getBullet()->setChar(8226);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Estableciendo el nivel de viñeta
    $para1->getParagraphFormat()->setDepth(0);
    # Creando el segundo párrafo
    $para2 = new Paragraph();
    # Estableciendo el estilo de viñeta del párrafo y el símbolo
    $para2->setText("Second level");
    $para2->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para2->getParagraphFormat()->getBullet()->setChar('-');
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Estableciendo el nivel de viñeta
    $para2->getParagraphFormat()->setDepth(1);
    # Creando el tercer párrafo
    $para3 = new Paragraph();
    # Estableciendo el estilo de viñeta del párrafo y el símbolo
    $para3->setText("Third level");
    $para3->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para3->getParagraphFormat()->getBullet()->setChar(8226);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Estableciendo el nivel de viñeta
    $para3->getParagraphFormat()->setDepth(2);
    # Creando el cuarto párrafo
    $para4 = new Paragraph();
    # Estableciendo el estilo de viñeta del párrafo y el símbolo
    $para4->setText("Fourth Level");
    $para4->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para4->getParagraphFormat()->getBullet()->setChar('-');
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Estableciendo el nivel de viñeta
    $para4->getParagraphFormat()->setDepth(3);
    # Añadiendo el párrafo 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 archivo PPTX
    $pres->save("MultilevelBullet.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Crear listas numeradas personalizadas

Aspose.Slides for PHP via Java proporciona una API sencilla para gestionar párrafos con formato de numeración personalizado. Para añadir una lista numerada personalizada en un párrafo, sigue los pasos a continuación:

Crear una instancia de la clase Presentation.
Acceder a la diapositiva deseada en la colección de diapositivas usando el objeto Slide.
Añadir un autoshape en la diapositiva seleccionada.
Acceder al TextFrame de la forma añadida.
Eliminar el párrafo predeterminado en el TextFrame.
Crear la primera instancia de párrafo usando la clase Paragraph y establecer NumberedBulletStartWith a 2
Crear la segunda instancia de párrafo usando la clase Paragraph y establecer NumberedBulletStartWith a 3
Crear la tercera instancia de párrafo usando la clase Paragraph y establecer NumberedBulletStartWith a 7
Añadir los párrafos creados a la colección de párrafos del TextFrame.
Guardar la presentación.

  # Instanciar una clase Presentation que representa un archivo PPTX
  $pres = new Presentation();
  try {
    # Accediendo a la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Añadiendo y accediendo al Autoshape
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Accediendo al marco de texto del autoshape creado
    $txtFrm = $aShp->addTextFrame("");
    # Eliminando el párrafo predeterminado existente
    $txtFrm->getParagraphs()->clear();
    # Primera lista
    $paragraph1 = new Paragraph();
    $paragraph1->setText("bullet 2");
    $paragraph1->getParagraphFormat()->setDepth(4);
    $paragraph1->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(2);
    $paragraph1->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $txtFrm->getParagraphs()->add($paragraph1);
    $paragraph2 = new Paragraph();
    $paragraph2->setText("bullet 3");
    $paragraph2->getParagraphFormat()->setDepth(4);
    $paragraph2->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(3);
    $paragraph2->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $txtFrm->getParagraphs()->add($paragraph2);
    # Segunda lista
    $paragraph5 = new Paragraph();
    $paragraph5->setText("bullet 5");
    $paragraph5->getParagraphFormat()->setDepth(4);
    $paragraph5->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(5);
    $paragraph5->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $txtFrm->getParagraphs()->add($paragraph5);
    $pres->save($resourcesOutputPath . "SetCustomBulletsNumber-slides.pptx.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

¿Pueden exportarse las listas con viñetas y numeradas creadas con Aspose.Slides a otros formatos como PDF o imágenes?

Sí, Aspose.Slides preserva completamente el formato y la estructura de las listas con viñetas y numeradas cuando las presentaciones se exportan a formatos como PDF, imágenes y otros, garantizando resultados consistentes.

¿Es posible importar listas con viñetas o numeradas desde presentaciones existentes?

Sí, Aspose.Slides permite importar y editar listas con viñetas o numeradas de presentaciones existentes, preservando su formato y apariencia originales.

¿Aspose.Slides admite listas con viñetas y numeradas en presentaciones creadas en varios idiomas?

Sí, Aspose.Slides admite totalmente presentaciones multilingües, permitiendo crear listas con viñetas y numeradas en cualquier idioma, incluido el uso de caracteres especiales o no latinos.

Formatear texto de PowerPoint en PHP Gestionar superíndice y subíndice en presentaciones usando PHP