Gestionar nodos de forma SmartArt en presentaciones usando PHP

Añadir un nodo SmartArt

Aspose.Slides for PHP via Java ha proporcionado la API más sencilla para gestionar las formas SmartArt de la manera más fácil. El siguiente fragmento de código de ejemplo le ayudará a añadir un nodo y un nodo hijo dentro de una forma SmartArt.

Cree una instancia de la clase Presentation y cargue la presentación con una forma SmartArt.
Obtenga la referencia de la primera diapositiva mediante su índice.
Recorra todas las formas dentro de la primera diapositiva.
Compruebe si la forma es de tipo SmartArt y convierta la forma seleccionada a SmartArt si es SmartArt.
Add a new Node en la colección NodeCollection de la forma SmartArt y establezca el texto en el TextFrame.
Ahora, Add un Child Node en el nodo SmartArt recién añadido y establezca el texto en el TextFrame.
Guarde la presentación.

  # Cargar la presentación deseada
  $pres = new Presentation("SimpleSmartArt.pptx");
  try {
    # Recorrer todas las formas dentro de la primera diapositiva
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {
      # Comprobar si la forma es de tipo SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Convertir la forma a SmartArt
        $smart = $shape;
        # Añadir un nuevo nodo SmartArt
        $TemNode = $smart->getAllNodes()->addNode();
        # Añadir texto
        $TemNode->getTextFrame()->setText("Test");
        # Añadir un nuevo nodo hijo en el nodo padre. Se añadirá al final de la colección
        $newNode = $TemNode->getChildNodes()->addNode();
        # Añadir texto
        $newNode->getTextFrame()->setText("New Node Added");
      }
    }
    # Guardar la presentación
    $pres->save("AddSmartArtNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Añadir un nodo SmartArt en una posición específica

En el siguiente fragmento de código de ejemplo explicamos cómo añadir los nodos hijos pertenecientes a los nodos respectivos de una forma SmartArt en una posición concreta.

Cree una instancia de la clase Presentation.
Obtenga la referencia de la primera diapositiva mediante su índice.
Añada una forma SmartArt del tipo StackedList en la diapositiva accedida.
Acceda al primer nodo de la forma SmartArt añadida.
Ahora, añada el Child Node para el Node seleccionado en la posición 2 y establezca su texto.
Guarde la presentación.

  # Crear una instancia de presentación
  $pres = new Presentation();
  try {
    # Acceder a la diapositiva de la presentación
    $slide = $pres->getSlides()->get_Item(0);
    # Añadir Smart Art IShape
    $smart = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::StackedList);
    # Acceder al nodo SmartArt en el índice 0
    $node = $smart->getAllNodes()->get_Item(0);
    # Añadir un nuevo nodo hijo en la posición 2 del nodo padre
    $chNode = $node->getChildNodes()->addNodeByPosition(2);
    # Añadir texto
    $chNode->getTextFrame()->setText("Sample Text Added");
    # Guardar la presentación
    $pres->save("AddSmartArtNodeByPosition.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Acceder a un nodo SmartArt

El siguiente fragmento de código de ejemplo le ayudará a acceder a los nodos dentro de una forma SmartArt. Tenga en cuenta que no puede cambiar el LayoutType del SmartArt, ya que es de solo lectura y se establece únicamente cuando se añade la forma SmartArt.

Cree una instancia de la clase Presentation y cargue la presentación con una forma SmartArt.
Obtenga la referencia de la primera diapositiva mediante su índice.
Recorra todas las formas dentro de la primera diapositiva.
Compruebe si la forma es de tipo SmartArt y convierta la forma seleccionada a SmartArt si es SmartArt.
Recorra todos los Nodes dentro de la forma SmartArt.
Acceda y muestre información como la posición del nodo SmartArt, su nivel y el texto.

  # Instanciar la clase Presentation
  $pres = new Presentation("SmartArtShape.pptx");
  try {
    # Obtener la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Recorrer todas las formas dentro de la primera diapositiva
    foreach($slide->getShapes() as $shape) {
      # Comprobar si la forma es de tipo SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Convertir la forma a SmartArt
        $smart = $shape;
        # Recorrer todos los nodos dentro de SmartArt
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          # Acceder al nodo SmartArt en el índice i
          $node = $smart->getAllNodes()->get_Item($i);
          # Imprimir los parámetros del nodo SmartArt
          System->out->print($node->getTextFrame()->getText() . " " . $node->getLevel() . " " . $node->getPosition());
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Acceder a un nodo hijo SmartArt

El siguiente fragmento de código de ejemplo le ayudará a acceder a los nodos hijos pertenecientes a los nodos respectivos de una forma SmartArt.

Cree una instancia de la clase Presentation y cargue la presentación con una forma SmartArt.
Obtenga la referencia de la primera diapositiva mediante su índice.
Recorra todas las formas dentro de la primera diapositiva.
Compruebe si la forma es de tipo SmartArt y convierta la forma seleccionada a SmartArt si es SmartArt.
Recorra todos los Nodes dentro de la forma SmartArt.
Para cada Node de la forma SmartArt seleccionada, recorra todos los Child Nodes dentro de ese nodo concreto.
Acceda y muestre información como la posición del Child Node, su nivel y el texto.

  # Instanciar la clase Presentation
  $pres = new Presentation("AccessChildNodes.pptx");
  try {
    # Obtener la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Recorrer todas las formas dentro de la primera diapositiva
    foreach($slide->getShapes() as $shape) {
      # Comprobar si la forma es de tipo SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Convertir la forma a SmartArt
        $smart = $shape;
        # Recorrer todos los nodos dentro de SmartArt
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          # Acceder al nodo SmartArt en el índice i
          $node0 = $smart->getAllNodes()->get_Item($i);
          # Recorrer los nodos hijos en el nodo SmartArt en el índice i
          for($j = 0; $j < java_values($node0->getChildNodes()->size()) ; $j++) {
            # Acceder al nodo hijo en el nodo SmartArt
            $node = $node0->getChildNodes()->get_Item($j);
            # Imprimir los parámetros del nodo hijo SmartArt
            System->out->print("j = " . $j . ", Text = " . $node->getTextFrame()->getText() . ",  Level = " . $node->getLevel() . ", Position = " . $node->getPosition());
          }
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Acceder a un nodo hijo SmartArt en una posición específica

En este ejemplo aprenderá a acceder a los nodos hijos en una posición concreta pertenecientes a los nodos de una forma SmartArt.

Cree una instancia de la clase Presentation.
Obtenga la referencia de la primera diapositiva mediante su índice.
Añada una forma SmartArt del tipo StackedList.
Acceda a la forma SmartArt añadida.
Acceda al nodo con índice 0 de la forma SmartArt.
Ahora, acceda al Child Node en la posición 1 del nodo SmartArt mediante el método get_Item().
Acceda y muestre información como la posición del Child Node, su nivel y el texto.

  # Instanciar la presentación
  $pres = new Presentation();
  try {
    # Acceder a la primera diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Añadir la forma SmartArt en la primera diapositiva
    $smart = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::StackedList);
    # Acceder al nodo SmartArt en el índice 0
    $node = $smart->getAllNodes()->get_Item(0);
    # Acceder al nodo hijo en la posición 1 del nodo padre
    $position = 1;
    $chNode = $node->getChildNodes()->get_Item($position);
    # Imprimir los parámetros del nodo hijo SmartArt
    System->out->print("Text = " . $chNode->getTextFrame()->getText() . ",  Level = " . $chNode->getLevel() . ", Position = " . $chNode->getPosition());
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Eliminar un nodo SmartArt

En este ejemplo aprenderá a eliminar los nodos dentro de una forma SmartArt.

Cree una instancia de la clase Presentation y cargue la presentación con una forma SmartArt.
Obtenga la referencia de la primera diapositiva mediante su índice.
Recorra todas las formas dentro de la primera diapositiva.
Compruebe si la forma es de tipo SmartArt y convierta la forma seleccionada a SmartArt si es SmartArt.
Compruebe si el SmartArt tiene más de 0 nodos.
Seleccione el nodo SmartArt que desea eliminar.
Ahora, elimine el nodo seleccionado mediante el método removeNode.
Guarde la presentación.

  # Cargar la presentación deseada
  $pres = new Presentation("AddSmartArtNode.pptx");
  try {
    # Recorrer todas las formas dentro de la primera diapositiva
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # Comprobar si la forma es de tipo SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Convertir la forma a SmartArt
        $smart = $shape;
        if (java_values($smart->getAllNodes()->size()) > 0) {
          # Acceder al nodo SmartArt en el índice 0
          $node = $smart->getAllNodes()->get_Item(0);
          # Eliminar el nodo seleccionado
          $smart->getAllNodes()->removeNode($node);
        }
      }
    }
    # Guardar la presentación
    $pres->save("RemoveSmartArtNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Eliminar un nodo SmartArt de una posición específica

En este ejemplo aprenderá a eliminar los nodos dentro de una forma SmartArt en una posición concreta.

Cree una instancia de la clase Presentation y cargue la presentación con una forma SmartArt.
Obtenga la referencia de la primera diapositiva mediante su índice.
Recorra todas las formas dentro de la primera diapositiva.
Compruebe si la forma es de tipo SmartArt y convierta la forma seleccionada a SmartArt si es SmartArt.
Seleccione el nodo de la forma SmartArt en el índice 0.
Ahora, compruebe si el nodo SmartArt seleccionado tiene más de 2 nodos hijos.
Elimine el nodo en la Posición 1 mediante el método removeNode.
Guarde la presentación.

  # Cargar la presentación deseada
  $pres = new Presentation("AddSmartArtNode.pptx");
  try {
    # Recorrer todas las formas dentro de la primera diapositiva
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # Comprobar si la forma es de tipo SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Convertir la forma a SmartArt
        $smart = $shape;
        if (java_values($smart->getAllNodes()->size()) > 0) {
          # Acceder al nodo SmartArt en el índice 0
          $node = $smart->getAllNodes()->get_Item(0);
          if (java_values($node->getChildNodes()->size()) >= 2) {
            # Eliminar el nodo hijo en la posición 1
            $node->getChildNodes()->removeNode(1);
          }
        }
      }
    }
    # Guardar la presentación
    $pres->save("RemoveSmartArtNodeByPosition.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Establecer una posición personalizada para un nodo hijo en un objeto SmartArt

Aspose.Slides for PHP via Java permite establecer las propiedades X y Y de SmartArtShape. El fragmento de código a continuación muestra cómo definir la posición, tamaño y rotación personalizados de una SmartArtShape; tenga en cuenta que añadir nuevos nodos causa una recalculación de las posiciones y tamaños de todos los nodos. Con los ajustes de posición personalizados, el usuario puede situar los nodos según sus requisitos.

  # Instanciar la clase Presentation
  $pres = new Presentation("SimpleSmartArt.pptx");
  try {
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(20, 20, 600, 500, SmartArtLayoutType::OrganizationChart);
    # Mover la forma SmartArt a una nueva posición
    $node = $smart->getAllNodes()->get_Item(1);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setX($shape->getX() . $shape->getWidth() * 2);
    $shape->setY($shape->getY() - $shape->getHeight() * 2);
    # Cambiar los anchos de la forma SmartArt
    $node = $smart->getAllNodes()->get_Item(2);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setWidth($shape->getWidth() . $shape->getWidth() * 2);
    # Cambiar la altura de la forma SmartArt
    $node = $smart->getAllNodes()->get_Item(3);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setHeight($shape->getHeight() . $shape->getHeight() * 2);
    # Cambiar la rotación de la forma SmartArt
    $node = $smart->getAllNodes()->get_Item(4);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setRotation(90);
    $pres->save("SmartArt.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Comprobar un nodo asistente

En este artículo investigaremos más a fondo las funciones de las formas SmartArt añadidas a las diapositivas de una presentación mediante Aspose.Slides for PHP via Java.

Utilizaremos la siguiente forma SmartArt como fuente para nuestras pruebas en las distintas secciones de este artículo.


Figura: Forma SmartArt de origen en la diapositiva

En el siguiente fragmento de código investigaremos cómo identificar los Assistant Nodes en la colección de nodos SmartArt y modificarlos.

Cree una instancia de la clase Presentation y cargue la presentación con una forma SmartArt.
Obtenga la referencia de la segunda diapositiva mediante su índice.
Recorra todas las formas dentro de la primera diapositiva.
Compruebe si la forma es de tipo SmartArt y convierta la forma seleccionada a SmartArt si es SmartArt.
Recorra todos los nodos dentro de la forma SmartArt y compruebe si son Assistant Nodes.
Cambie el estado del nodo asistente a nodo normal.
Guarde la presentación.

  # Crear una instancia de presentación
  $pres = new Presentation("AddNodes.pptx");
  try {
    # Recorrer todas las formas dentro de la primera diapositiva
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # Comprobar si la forma es de tipo SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Convertir la forma a SmartArt
        $smart = $shape;
        # Recorrer todos los nodos de la forma SmartArt
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          $node = $smart->getAllNodes()->get_Item($i);
          # Comprobar si el nodo es un nodo Asistente
          if ($node->isAssistant()) {
            # Establecer el nodo Asistente a false y convertirlo en nodo normal
            $node->isAssistant();
          }
        }
      }
    }
    # Guardar la presentación
    $pres->save("ChangeAssitantNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }


Figura: Nodos asistente modificados en la forma SmartArt de la diapositiva

Establecer el formato de relleno de un nodo

Aspose.Slides for PHP via Java permite añadir formas SmartArt personalizadas y definir su formato de relleno. Este artículo explica cómo crear y acceder a formas SmartArt y establecer su formato de relleno mediante Aspose.Slides for PHP via Java.

Siga los pasos a continuación:

Cree una instancia de la clase Presentation.
Obtenga la referencia de una diapositiva usando su índice.
Añada una forma SmartArt estableciendo su LayoutType.
Defina el Fill Format para los nodos de la forma SmartArt.
Guarde la presentación modificada como archivo PPTX.

  # Instanciar la presentación
  $pres = new Presentation();
  try {
    # Accediendo a la diapositiva
    $slide = $pres->getSlides()->get_Item(0);
    # Añadiendo forma SmartArt y nodos
    $chevron = $slide->getShapes()->addSmartArt(10, 10, 800, 60, SmartArtLayoutType::ClosedChevronProcess);
    $node = $chevron->getAllNodes()->addNode();
    $node->getTextFrame()->setText("Some text");
    # Estableciendo el color de relleno del nodo
    foreach($node->getShapes() as $item) {
      $item->getFillFormat()->setFillType(FillType::Solid);
      $item->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    }
    # Guardar la presentación
    $pres->save("TestSmart.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Generar una miniatura de un nodo hijo SmartArt

Los desarrolladores pueden generar una miniatura del nodo hijo de un SmartArt siguiendo los pasos a continuación:

Cree una instancia de la clase Presentation.
Add SmartArt.
Obtenga la referencia de un nodo mediante su índice.
Obtenga la imagen en miniatura.
Guarde la imagen en miniatura en el formato de imagen que desee.

  # Instanciar la clase Presentation que representa el archivo PPTX
  $pres = new Presentation();
  try {
    # Añadir SmartArt
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicCycle);
    # Obtener la referencia de un nodo mediante su índice
    $node = $smart->getNodes()->get_Item(1);
    # Obtener miniatura
    $slideImage = $node->getShapes()->get_Item(0)->getImage();
    # Guardar miniatura
    try {
      $slideImage->save("SmartArt_ChildNote_Thumbnail.png", ImageFormat::Png);
    } finally {
      if (!java_is_null($slideImage)) {
        $slideImage->dispose();
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

¿Se admite la animación de SmartArt?

Sí. SmartArt se trata como una forma normal, por lo que puede aplicar animaciones estándar (entrada, salida, énfasis, rutas de movimiento) y ajustar la sincronización. También puede animar formas dentro de los nodos SmartArt cuando sea necesario.

¿Cómo puedo localizar de forma fiable un SmartArt específico en una diapositiva si su ID interno es desconocido?

Asigne y busque por texto alternativo. Establecer un AltText distintivo en el SmartArt le permite encontrarlo programáticamente sin depender de identificadores internos.

¿Se preservará la apariencia de SmartArt al convertir la presentación a PDF?

Sí. Aspose.Slides renderiza SmartArt con alta fidelidad visual durante la exportación a PDF, conservando el diseño, colores y efectos.

¿Puedo extraer una imagen de todo el SmartArt (para vistas previas o informes)?

Sí. Puede renderizar una forma SmartArt a [formatos raster]https://reference.aspose.com/slides/php-java/aspose.slides/shape/#getImage) o a SVG para obtener una salida vectorial escalable, lo que la hace adecuada para miniaturas, informes o uso web.

Gestionar gráficos SmartArt en presentaciones con PHP