Gestionar SmartArt en presentaciones de PowerPoint usando PHP

Obtener texto de un objeto SmartArt

Ahora se ha añadido el método TextFrame a la clase SmartArtShape respectivamente. Esta propiedad le permite obtener todo el texto de SmartArt incluso si no solo contiene texto de nodos. El siguiente código de ejemplo le ayudará a obtener el texto de un nodo SmartArt.

  $pres = new Presentation("Presentation.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $smartArt = $slide->getShapes()->get_Item(0);
    $smartArtNodes = $smartArt->getAllNodes();
    foreach($smartArtNodes as $smartArtNode) {
      foreach($smartArtNode->getShapes() as $nodeShape) {
        if (!java_is_null($nodeShape->getTextFrame())) {
          echo($nodeShape->getTextFrame()->getText());
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Cambiar el tipo de diseño de un objeto SmartArt

Para cambiar el tipo de diseño de SmartArt. Siga los pasos a continuación:

Cree una instancia de la clase Presentation.
Obtenga la referencia de una diapositiva mediante su índice.
Añada SmartArt BasicBlockList.
Cambie LayoutType a BasicProcess.
Guarde la presentación como un archivo PPTX.
En el ejemplo que se muestra a continuación, se ha añadido un conector entre dos formas.

  $pres = new Presentation();
  try {
    # Añadir SmartArt BasicProcess
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicBlockList);
    # Cambiar LayoutType a BasicProcess
    $smart->setLayout(SmartArtLayoutType::BasicProcess);
    # Guardar presentación
    $pres->save("ChangeSmartArtLayout_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Comprobar la propiedad Oculta de un objeto SmartArt

Tenga en cuenta: el método SmartArtNode::isHidden() devuelve true si este nodo está oculto en el modelo de datos. Para comprobar la propiedad oculta de cualquier nodo de SmartArt. Siga los pasos a continuación:

Cree una instancia de la clase Presentation.
Añada SmartArt RadialCycle.
Añada un nodo en SmartArt.
Compruebe la propiedad de visibility.
Guarde la presentación como un archivo PPTX.
En el ejemplo que se muestra a continuación, se ha añadido un conector entre dos formas.

  $pres = new Presentation();
  try {
    # Añadir SmartArt BasicProcess
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::RadialCycle);
    # Añadir nodo en SmartArt
    $node = $smart->getAllNodes()->addNode();
    # Comprobar la propiedad isHidden
    $hidden = $node->isHidden();// Devuelve true

    if ($hidden) {
      # Realizar algunas acciones o notificaciones
    }
    # Guardar presentación
    $pres->save("CheckSmartArtHiddenProperty_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Obtener o establecer el tipo de organigrama

Los métodos SmartArtNode::getOrganizationChartLayout() y SmartArtNode::setOrganizationChartLayout(int) permiten obtener o establecer el tipo de organigrama asociado al nodo actual. Para obtener o establecer el tipo de organigrama, siga los pasos a continuación:

Cree una instancia de la clase Presentation.
Añada SmartArt en la diapositiva.
Obtenga o establezca el tipo de organigrama.
Guarde la presentación como un archivo PPTX.
En el ejemplo que se muestra a continuación, se ha añadido un conector entre dos formas.

  $pres = new Presentation();
  try {
    # Añadir SmartArt BasicProcess
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::OrganizationChart);
    # Obtener o establecer el tipo de organigrama
    $smart->getNodes()->get_Item(0)->setOrganizationChartLayout(OrganizationChartLayoutType::LeftHanging);
    # Guardar presentación
    $pres->save("OrganizeChartLayoutType_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Crear un organigrama PictureOrganization

Aspose.Slides for PHP via Java ofrece una API sencilla para crear diagramas PictureOrganization de forma fácil. Para crear un diagrama en una diapositiva:

Cree una instancia de la clase Presentation.
Obtenga la referencia de una diapositiva mediante su índice.
Añada un diagrama con datos predeterminados y el tipo deseado (ChartType::PictureOrganizationChart).
Guarde la presentación modificada en un archivo PPTX

El siguiente código se utiliza para crear un diagrama.

  $pres = new Presentation("test.pptx");
  try {
    $smartArt = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::PictureOrganizationChart);
    $pres->save("OrganizationChart.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Obtener o establecer el estado de SmartArt

Para cambiar el tipo de diseño de SmartArt. Siga los pasos a continuación:

Cree una instancia de la clase Presentation.
Añada SmartArt en la diapositiva.
Get o Set el estado del diagrama SmartArt.
Guarde la presentación como un archivo PPTX.

El siguiente código se utiliza para crear un diagrama.

  # Instanciar la clase Presentation que representa el archivo PPTX
  $pres = new Presentation();
  try {
    # Añadir SmartArt BasicProcess
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicProcess);
    # Obtener o establecer el estado del diagrama SmartArt
    $smart->setReversed(true);
    $flag = $smart->isReversed();
    # Guardar la presentación
    $pres->save("output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

¿SmartArt admite espejado/inversión para idiomas RTL?

Sí. El método setReversed cambia la dirección del diagrama (LTR/RTL) si el tipo de SmartArt seleccionado admite la inversión.

¿Cómo puedo copiar SmartArt a la misma diapositiva o a otra presentación conservando el formato?

Puede clonar la forma SmartArt mediante la colección de formas (ShapeCollection::addClone) o clonar toda la diapositiva que contiene esta forma. Ambos enfoques conservan el tamaño, la posición y el estilo.

¿Cómo renderizo SmartArt a una imagen rasterizada para vista previa o exportación web?

Renderice la diapositiva (o toda la presentación) a PNG/JPEG mediante la API que convierte diapositivas/presentaciones en imágenes—SmartArt se dibujará como parte de la diapositiva.

¿Cómo puedo seleccionar programáticamente un SmartArt específico en una diapositiva si hay varios?

Una práctica común es usar el texto alternativo (Alt Text) o un nombre y buscar la forma por ese atributo dentro de slide shapes, luego comprobar el tipo para confirmar que es SmartArt. La documentación describe técnicas típicas para encontrar y trabajar con formas.

Gestionar gráficos SmartArt en presentaciones con PHP