Gestionar SmartArt en presentaciones de PowerPoint usando Java

Visión general

SmartArt es un diagrama de PowerPoint compuesto por nodos, formas de nodo y un diseño. Con Aspose.Slides for Java, puedes crear SmartArt, leer texto de sus nodos, cambiar su diseño, inspeccionar nodos ocultos, configurar diseños de organigramas y crear organigramas con imágenes.

Obtener texto de un objeto SmartArt

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

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

    if (shape instanceof ISmartArt) {
        ISmartArt smartArt = (ISmartArt) shape;

        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 diseño de un objeto SmartArt

El diseño de SmartArt controla cómo se disponen 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.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);

    smartArt.setLayout(SmartArtLayoutType.BasicProcess);

    presentation.save("ChangeSmartArtLayout_out.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 el diseño seleccionado 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 y comprueba el estado oculto del nodo.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).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_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Obtener o establecer el diseño del organigrama

Para los diagramas SmartArt que utilizan un diseño de organigrama, ISmartArtNode.getOrganizationChartLayout y ISmartArtNode.setOrganizationChartLayout definen cómo se disponen los nodos hijos bajo un nodo padre. Por ejemplo, puedes hacer que los nodos hijos cuelguen a la izquierda, a la derecha o en ambos lados, según el OrganizationChartLayoutType seleccionado.

El siguiente ejemplo crea un organigrama y establece el diseño del primer nodo al valor LeftHanging de OrganizationChartLayoutType.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);

    ISmartArtNode rootNode = smartArt.getNodes().get_Item(0);
    rootNode.setOrganizationChartLayout(OrganizationChartLayoutType.LeftHanging);

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

Crear un organigrama con imágenes

Un organigrama con imágenes es un diseño SmartArt creado para diagramas jerárquicos que incluyen marcadores de posición de imágenes. Usa el valor PictureOrganizationChart de SmartArtLayoutType al añadir el objeto SmartArt a una diapositiva.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);

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

Preguntas frecuentes

¿SmartArt admite reflejo 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 el diseño SmartArt seleccionado 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 toda la diapositiva que contiene el SmartArt. Ambos enfoques conservan el tamaño, la posición y el formato.

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

Renderiza la diapositiva o la presentación completa 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?

Asigna un valor distintivo a Shape.getAlternativeText o a Shape.getName en la forma SmartArt, busca ese valor en BaseSlide.getShapes, y luego verifica que la forma coincidente sea un ISmartArt.