Gestionar SmartArt en presentaciones de PowerPoint usando Java

Visión general

SmartArt es un diagrama de PowerPoint formado por nodos, formas de nodo y una disposición. Con Aspose.Slides for Java, puedes crear SmartArt, leer texto de sus nodos, cambiar su disposición, inspeccionar nodos ocultos, configurar disposiciones de organigramas y crear organigramas con imágenes.

Obtener texto de un objeto SmartArt

Un nodo de SmartArt puede contener una o más formas. Para leer el texto de las formas del nodo, itera a través de ISmartArt.getAllNodes, luego lee el ITextFrame devuelto por ISmartArtShape.getTextFrame.

El ejemplo requiere una presentación con al menos una diapositiva y un objeto SmartArt como la primera forma en esa diapositiva. Imprime cada marco de texto disponible en la consola.

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = (ISmartArt) slide.getShapes().get_Item(0);
    for (ISmartArtNode node : smartArt.getAllNodes()) {
        for (ISmartArtShape nodeShape : node.getShapes()) {
            if (nodeShape.getTextFrame() != null) {
                System.out.println(nodeShape.getTextFrame().getText());
            }
        }
    }
} finally {
    presentation.dispose();
}

Cambiar el tipo de disposición de un objeto SmartArt

La disposición de SmartArt controla cómo se organizan y conectan los nodos. El siguiente ejemplo crea un objeto SmartArt con el valor BasicBlockList de SmartArtLayoutType , lo cambia al valor BasicProcess y guarda la presentación. La posición y el tamaño pasados a IShapeCollection.addSmartArt se miden en puntos. Usa ISmartArt.setLayout para cambiar la disposición.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
    smartArt.setLayout(SmartArtLayoutType.BasicProcess);

    presentation.save("ChangeSmartArtLayout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Comprobar si un nodo SmartArt está oculto

ISmartArtNode.isHidden indica si el nodo está oculto en el modelo de datos de SmartArt. Los nodos ocultos pueden existir en la estructura incluso cuando la disposición seleccionada no los muestra como elementos visibles del diagrama.

El siguiente ejemplo añade un nodo a un objeto SmartArt que utiliza el valor RadialCycle de SmartArtLayoutType . Comprueba el estado oculto del nodo añadido. Imprime un mensaje si el nodo está oculto y guarda el diagrama.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);
    ISmartArtNode node = smartArt.getAllNodes().addNode();
    boolean isHidden = node.isHidden();

    if (isHidden) {
        System.out.println("The node is hidden in the SmartArt data model.");
    }

    presentation.save("CheckSmartArtHiddenProperty.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Obtener o establecer la disposición del organigrama

Para los diagramas SmartArt que utilizan una disposición de organigrama, ISmartArtNode.getOrganizationChartLayout y ISmartArtNode.setOrganizationChartLayout definen cómo se organizan los nodos hijo bajo un nodo padre. Por ejemplo, puedes establecer que los nodos hijo cuelguen a la izquierda, derecha o ambos lados, según el OrganizationChartLayoutType seleccionado.

El siguiente ejemplo crea un organigrama y establece la disposición del primer nodo al valor LeftHanging de OrganizationChartLayoutType . El índice basado en cero 0 selecciona el primer nodo de nivel superior; sus nodos hijo utilizan la disposición seleccionada. La presentación modificada se guarda entonces.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);
    ISmartArtNode rootNode = smartArt.getNodes().get_Item(0);
    rootNode.setOrganizationChartLayout(OrganizationChartLayoutType.LeftHanging);

    presentation.save("OrganizationChartLayout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Crear un organigrama con imagen

Un organigrama con imagen es una disposición de SmartArt diseñada para diagramas jerárquicos que incluyen marcadores de posición de imagen. Usa el valor PictureOrganizationChart de SmartArtLayoutType al añadir el objeto SmartArt a una diapositiva. Este ejemplo guarda un diagrama con marcadores de posición de imagen; no rellena los marcadores con imágenes.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);

    presentation.save("PictureOrganizationChart.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Convertir diagramas heredados a grupos de formas

Al modernizar una presentación existente, puede que necesites actualizar un organigrama creado originalmente en PowerPoint 97–2003. Aspose.Slides representa estos diagramas heredados como objetos ILegacyDiagram . Usa LegacyDiagram.convertToGroupShape para convertir un diagrama en un grupo de formas, de modo que puedas editar elementos visuales individuales. Consulta la LegacyDiagram API Reference para más detalles.

La conversión añade un nuevo grupo a la colección de formas sin eliminar el diagrama original. Tras una conversión exitosa, elimina el original con IShapeCollection.remove para evitar contenido duplicado. Recopila los diagramas heredados en una lista antes de convertirlos, de modo que añadir y eliminar formas no interrumpa la iteración.

El siguiente ejemplo abre una presentación, busca en cada diapositiva, convierte los diagramas en grupos de formas y guarda la presentación actualizada como PPTX.

import com.aspose.slides.*;
import java.util.ArrayList;
import java.util.List;

Presentation presentation = new Presentation("legacy-diagrams.ppt");
try {
    for (ISlide slide : presentation.getSlides()) {
        List<ILegacyDiagram> legacyDiagrams = new ArrayList<>();
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof ILegacyDiagram) {
                legacyDiagrams.add((ILegacyDiagram) shape);
            }
        }

        for (ILegacyDiagram legacyDiagram : legacyDiagrams) {
            IGroupShape groupShape = legacyDiagram.convertToGroupShape();

            if (groupShape != null) {
                slide.getShapes().remove(legacyDiagram);
            }
        }
    }

    presentation.save("modernized.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

La presentación guardada contiene grupos de formas editables en lugar de los diagramas heredados convertidos, sin diagramas originales restantes junto a ellos. Abre el PPTX en PowerPoint para editar los elementos individuales dentro de cada grupo, como su texto, relleno o posición.

Preguntas frecuentes

¿SmartArt admite la reflexión o inversión para idiomas RTL?
Sí. El método ISmartArt.setReversed cambia la dirección del diagrama de izquierda a derecha a derecha a izquierda, o viceversa, cuando la disposición de SmartArt seleccionada admite la inversión.

¿Cómo puedo copiar SmartArt a la misma diapositiva o a otra presentación preservando el formato?
Puedes clonar la forma SmartArt con ShapeCollection.addClone o clonar la diapositiva completa que contiene el SmartArt. Ambos enfoques conservan el tamaño, la posición y el formato.

¿Cómo renderizo SmartArt a una imagen rasterizada para vista previa o exportación web?
Renderiza la diapositiva o toda la presentación a PNG o JPEG. SmartArt se renderiza como parte de la diapositiva.

¿Cómo puedo encontrar un objeto SmartArt específico en una diapositiva si hay varios?
Utiliza Shape.setAlternativeText o Shape.setName para asignar un texto alternativo o un nombre distintivo a la forma SmartArt, busca ese valor en BaseSlide.getShapes , y luego verifica que la forma coincidente sea un ISmartArt.