Gerenciar Gráficos SmartArt em Apresentações Usando Python

Sobre o que é esta página

Automatize a criação, edição e estilização de SmartArt no PowerPoint em Python usando Aspose.Slides, com exemplos de código concisos e orientações focadas em desempenho.

Visão geral

Aspose.Slides permite criar e gerenciar gráficos SmartArt em apresentações do PowerPoint programaticamente. Este artigo explica como adicionar uma forma SmartArt a um slide, acessar formas SmartArt existentes, encontrar SmartArt por um tipo de layout específico e atualizar sua aparência visual alterando o estilo SmartArt ou o estilo de cor.

Os exemplos mostram como trabalhar com formas SmartArt através da coleção de formas do slide da apresentação, verificar se uma forma é SmartArt e então modificar ou inspecionar suas propriedades.

Criar uma forma SmartArt

Aspose.Slides for Python via Java fornece uma API para criar formas SmartArt. Para criar uma forma SmartArt em um slide, siga as etapas abaixo:

Crie uma instância da Presentation class.
Obtenha um slide pelo seu índice.
Adicionar um SmartArt shape especificando um SmartArtLayoutType.
Salve a apresentação modificada como um arquivo PPTX.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation()
try:
    # Obter o primeiro slide.
    slide = presentation.getSlides().get_Item(0)

    # Adicionar uma forma SmartArt.
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.BasicBlockList)

    # Salvar a apresentação.
    presentation.save("SimpleSmartArt.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Figura: Forma SmartArt adicionada ao slide

Acessar uma forma SmartArt em um slide

O exemplo a seguir acessa formas SmartArt em um slide de apresentação. Ele itera por todas as formas do slide e verifica se a forma é uma instância de SmartArt.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # Iterar por todas as formas no primeiro slide.
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            print("Shape Name: " + str(smart_art.getName()))
finally:
    presentation.dispose()

Acessar uma forma SmartArt com um tipo de layout específico

O exemplo a seguir acessa uma forma SmartArt com um tipo de layout específico, retornado por SmartArt.getLayout.

Crie uma instância da Presentation class e carregue a apresentação que contém uma forma SmartArt.
Obtenha o primeiro slide pelo seu índice.
Itere por todas as formas do primeiro slide.
Verifique se a forma é uma instância de SmartArt.
Verifique se a forma SmartArt tem o tipo de layout especificado e execute a operação necessária.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArt, SmartArtLayoutType

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # Iterar por todas as formas no primeiro slide.
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # Verificar o layout do SmartArt.
            if smart_art.getLayout() == SmartArtLayoutType.BasicBlockList:
                print("Perform the required operation here.")
finally:
    presentation.dispose()

Alterar o estilo de uma forma SmartArt

Este exemplo mostra como alterar o estilo rápido de uma forma SmartArt.

Crie uma instância da Presentation class e carregue a apresentação que contém uma forma SmartArt.
Obtenha o primeiro slide pelo seu índice.
Itere por todas as formas do primeiro slide.
Verifique se a forma é uma instância de SmartArt.
Encontre a forma SmartArt com o estilo especificado.
Defina o novo estilo para a forma SmartArt.
Salve a apresentação.

import jpage
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtQuickStyleType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # Iterar por todas as formas no primeiro slide.
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # Verificar e alterar o estilo do SmartArt.
            if smart_art.getQuickStyle() == SmartArtQuickStyleType.SimpleFill:
                smart_art.setQuickStyle(SmartArtQuickStyleType.Cartoon)

    presentation.save("ChangeSmartArtStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Figura: Forma SmartArt com estilo alterado

Alterar o estilo de cor de uma forma SmartArt

Este exemplo acessa uma forma SmartArt com um estilo de cor específico e altera esse estilo.

Crie uma instância da Presentation class e carregue a apresentação que contém uma forma SmartArt.
Obtenha o primeiro slide pelo seu índice.
Itere por todas as formas do primeiro slide.
Verifique se a forma é uma instância de SmartArt.
Encontre a forma SmartArt com o estilo de cor especificado.
Defina o novo estilo de cor para a forma SmartArt.
Salve a apresentação.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtColorType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # Iterar por todas as formas no primeiro slide.
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # Verificar e alterar o estilo do SmartArt.
            if smart_art.getColorStyle() == SmartArtColorType.ColoredFillAccent1:
                smart_art.setColorStyle(SmartArtColorType.ColorfulAccentColors)

    presentation.save("ChangeSmartArtColorStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Figura: Forma SmartArt com estilo de cor alterado

FAQ

Posso animar SmartArt como um único objeto?

Sim. SmartArt é uma forma, portanto você pode aplicar standard animations via a API de animações (entrada, saída, ênfase, caminhos de movimento) da mesma forma que para outras formas.

Como posso encontrar um SmartArt específico em um slide se não conheço seu ID interno?

Defina e use o alternative text e procure a forma por esse valor — essa é a forma recomendada para localizar a forma alvo.

Posso agrupar SmartArt com outras formas?

Sim. Você pode agrupar SmartArt com outras formas (imagens, tabelas, etc.) e então manipulate the group.

Como obtenho uma imagem de um SmartArt específico (por exemplo, para pré‑visualização ou relatório)?

Exporte uma miniatura/imagem da forma; a biblioteca pode render individual shapes para arquivos raster (PNG/JPG/TIFF).

A aparência do SmartArt será preservada ao converter toda a apresentação para PDF?

Sim. O motor de renderização visa alta fidelidade para PDF export, com uma variedade de opções de qualidade e compatibilidade.

Gerenciar SmartArt em Apresentações PowerPoint Usando Python Gerenciar nós de forma SmartArt em apresentações usando Python