Gestionar nodos de forma SmartArt en presentaciones usando Python

De qué trata esta página

Gestiona los nodos de forma SmartArt en PPT y PPTX con Aspose.Slides para Python a través de Java. Obtén ejemplos de código claros y consejos para optimizar tus presentaciones.

Resumen

Los gráficos SmartArt en presentaciones de PowerPoint se organizan mediante nodos que contienen texto y definen la estructura del diagrama. Aspose.Slides permite trabajar con estos nodos SmartArt de forma programática: añadir nuevos nodos y nodos secundarios, insertar nodos secundarios en una posición concreta, acceder a nodos existentes y leer su texto, nivel y posición.

Este artículo explica cómo gestionar los nodos de forma de SmartArt. Muestra cómo eliminar nodos, trabajar con nodos secundarios por índice o posición, cambiar un nodo asistente a nodo normal, ajustar la posición, tamaño y rotación de las formas de los nodos SmartArt, establecer formatos de relleno de los nodos y generar una imagen en miniatura para un nodo secundario de SmartArt.

Añadir un nodo SmartArt

Aspose.Slides for Python via Java proporciona una API para gestionar formas SmartArt. El siguiente ejemplo añade un nodo y un nodo secundario a una forma SmartArt.

Crear una instancia de la Presentación y cargar la presentación que contiene una forma SmartArt.
Obtener la primera diapositiva por su índice.
Recorrer todas las formas de la primera diapositiva.
Comprobar si la forma es una instancia de SmartArt.
Añadir un nuevo nodo a la colección de nodos de la forma SmartArt y establecer su texto mediante TextFrame.
Añadir un nodo secundario al nuevo nodo y establecer su texto mediante TextFrame.
Guardar la presentación.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("SimpleSmartArt.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            node = smart_art.getAllNodes().addNode()
            node.getTextFrame().setText("Test")
            child_node = node.getChildNodes().addNode()
            child_node.getTextFrame().setText("New Node Added")
    presentation.save("AddSmartArtNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

El siguiente ejemplo añade un nodo secundario en una posición concreta dentro de un nodo SmartArt.

Crear una instancia de la Presentación.
Obtener la primera diapositiva por su índice.
Añadir una forma SmartArt con el diseño StackedList a la diapositiva.
Acceder al primer nodo de la forma SmartArt añadida.
Añadir un nodo secundario al nodo seleccionado en la posición 2 mediante addNodeByPosition y establecer su texto.
Guardar la presentación.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList)
    node = smart_art.getAllNodes().get_Item(0)
    child_node = node.getChildNodes().addNodeByPosition(2)
    child_node.getTextFrame().setText("Sample Text Added")
    presentation.save("AddSmartArtNodeByPosition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Acceder a un nodo SmartArt

El siguiente ejemplo accede a los nodos de una forma SmartArt. El diseño devuelto por getLayout es de solo lectura y se establece cuando se añade la forma SmartArt.

Crear una instancia de la Presentación y cargar la presentación que contiene una forma SmartArt.
Obtener la primera diapositiva por su índice.
Recorrer todas las formas de la primera diapositiva.
Comprobar si la forma es una instancia de SmartArt.
Recorrer todos los nodos de la forma SmartArt.
Leer y mostrar la posición, nivel y texto de cada nodo SmartArt.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("SmartArtShape.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                node = smart_art.getAllNodes().get_Item(i)
                print(node.getTextFrame().getText(), " ", node.getLevel(), " ", node.getPosition())
finally:
    presentation.dispose()

Acceder a un nodo secundario de SmartArt

El siguiente ejemplo accede a los nodos secundarios de cada nodo en una forma SmartArt.

Crear una instancia de la Presentación y cargar la presentación que contiene una forma SmartArt.
Obtener la primera diapositiva por su índice.
Recorrer todas las formas de la primera diapositiva.
Comprobar si la forma es una instancia de SmartArt.
Recorrer todos los nodos de la forma SmartArt.
Para cada nodo, recorrer sus nodos secundarios.
Leer y mostrar la posición, nivel y texto del nodo secundario.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessChildNodes.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                parent_node = smart_art.getAllNodes().get_Item(i)
                for j in range(parent_node.getChildNodes().size()):
                    node = parent_node.getChildNodes().get_Item(j)
                    print("j = ", j, ", Text = ", node.getTextFrame().getText(), ",  Level = ", node.getLevel(), ", Position = ", node.getPosition())
finally:
    presentation.dispose()

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

El siguiente ejemplo accede a un nodo secundario en un índice concreto dentro de la colección del nodo principal.

Crear una instancia de la Presentación.
Obtener la primera diapositiva por su índice.
Añadir una forma SmartArt con el diseño StackedList.
Acceder a la forma SmartArt añadida.
Acceder al nodo en el índice 0 de la forma SmartArt.
Acceder al nodo secundario en el índice 1 mediante get_Item.
Leer y mostrar la posición, nivel y texto del nodo secundario.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArtLayoutType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList)
    node = smart_art.getAllNodes().get_Item(0)
    position = 1
    child_node = node.getChildNodes().get_Item(position)
    print("Text = ", child_node.getTextFrame().getText(), ",  Level = ", child_node.getLevel(), ", Position = ", child_node.getPosition())
finally:
    presentation.dispose()

Eliminar un nodo SmartArt

El siguiente ejemplo elimina un nodo de una forma SmartArt.

Crear una instancia de la Presentación y cargar la presentación que contiene una forma SmartArt.
Obtener la primera diapositiva por su índice.
Recorrer todas las formas de la primera diapositiva.
Comprobar si la forma es una instancia de SmartArt.
Verificar que la forma SmartArt contiene al menos un nodo.
Seleccionar el nodo SmartArt que se va a eliminar.
Eliminar el nodo seleccionado mediante removeNode.
Guardar la presentación.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddSmartArtNode.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            if smart_art.getAllNodes().size() > 0:
                node = smart_art.getAllNodes().get_Item(0)
                smart_art.getAllNodes().removeNode(node)
    presentation.save("RemoveSmartArtNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

El siguiente ejemplo elimina un nodo secundario en un índice concreto dentro de la colección de un nodo SmartArt.

Crear una instancia de la Presentación y cargar la presentación que contiene una forma SmartArt.
Obtener la primera diapositiva por su índice.
Recorrer todas las formas de la primera diapositiva.
Comprobar si la forma es una instancia de SmartArt.
Acceder al nodo SmartArt en el índice 0 si existe.
Verificar que el nodo SmartArt seleccionado tiene al menos dos nodos secundarios.
Eliminar el nodo secundario en el índice 1 mediante removeNode.
Guardar la presentación.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddSmartArtNode.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            if smart_art.getAllNodes().size() > 0:
                node = smart_art.getAllNodes().get_Item(0)
                if node.getChildNodes().size() >= 2:
                    node.getChildNodes().removeNode(1)
    presentation.save("RemoveSmartArtNodeByPosition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

Aspose.Slides for Python via Java permite establecer la posición de un SmartArtShape mediante setX y setY. El siguiente ejemplo define una posición, tamaño y rotación personalizada para las formas de los nodos SmartArt. Añadir nuevos nodos recalcula las posiciones y tamaños de todos los nodos. La posición personalizada permite organizar los nodos según sea necesario.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    smart_art = presentation.getSlides().get_Item(0).getShapes().addSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart)
    node = smart_art.getAllNodes().get_Item(1)
    shape = node.getShapes().get_Item(1)
    shape.setX(shape.getX() + shape.getWidth() * 2)
    shape.setY(shape.getY() - shape.getHeight() * 2)
    node = smart_art.getAllNodes().get_Item(2)
    shape = node.getShapes().get_Item(1)
    shape.setWidth(shape.getWidth() + shape.getWidth() * 2)
    node = smart_art.getAllNodes().get_Item(3)
    shape = node.getShapes().get_Item(1)
    shape.setHeight(shape.getHeight() + shape.getHeight() * 2)
    node = smart_art.getAllNodes().get_Item(4)
    shape = node.getShapes().get_Item(1)
    shape.setRotation(90)
    presentation.save("SmartArt.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Comprobar un nodo asistente

Note

Esta sección explora las formas SmartArt añadidas a diapositivas de presentación de forma programática mediante Aspose.Slides for Python via Java.

La forma SmartArt de origen utilizada en este ejemplo es la siguiente.


Figura: Forma SmartArt de origen en una diapositiva

El siguiente ejemplo identifica nodos asistentes en una colección de nodos SmartArt y los transforma en nodos normales.

Crear una instancia de la Presentación y cargar la presentación que contiene una forma SmartArt.
Obtener la primera diapositiva por su índice.
Recorrer todas las formas de la primera diapositiva.
Comprobar si la forma es una instancia de SmartArt.
Recorrer todos los nodos de la forma SmartArt y comprobar si son Assistant Nodes.
Cambiar cada nodo asistente a un nodo normal.
Guardar la presentación.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddNodes.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                node = smart_art.getAllNodes().get_Item(i)
                if node.isAssistant():
                    node.setAssistant(False)
    presentation.save("ChangeAssistantNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Figura: Nodos asistentes modificados en una forma SmartArt sobre una diapositiva

Establecer el formato de relleno de un nodo

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

Siga los pasos a continuación:

Crear una instancia de la Presentación.
Obtener una diapositiva por su índice.
Añadir una forma SmartArt con el diseño ClosedChevronProcess.
Establecer el FillFormat para los nodos de la forma SmartArt.
Guardar la presentación modificada como archivo PPTX.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType, FillType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chevron = slide.getShapes().addSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess)
    node = chevron.getAllNodes().addNode()
    node.getTextFrame().setText("Some text")
    for item in node.getShapes():
        item.getFillFormat().setFillType(FillType.Solid)
        item.getFillFormat().getSolidFillColor().setColor(Color.RED)
    presentation.save("TestSmart.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Generar una miniatura de un nodo secundario de SmartArt

Para generar una miniatura de un nodo secundario de SmartArt, siga estos pasos:

Crear una instancia de la Presentación.
Añadir una forma SmartArt.
Obtener un nodo por su índice.
Obtener la imagen en miniatura.
Guardar la imagen en miniatura en el formato de imagen deseado.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArtLayoutType, ImageFormat

presentation = Presentation()
try:
    smart_art = presentation.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle)
    node = smart_art.getNodes().get_Item(1)
    image = node.getShapes().get_Item(0).getImage()
    try:
        image.save("SmartArt_ChildNode_Thumbnail.png", ImageFormat.Png)
    finally:
        image.dispose()
finally:
    presentation.dispose()

Preguntas frecuentes

¿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, trayectorias de movimiento) y ajustar la sincronización. También puede animar las formas dentro de los nodos SmartArt cuando sea necesario.

¿Cómo 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 texto alternativo distintivo en el SmartArt 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, preservando 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 rasterizados 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 usando Python