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

Visão Geral

Aspose.Slides permite que você crie e gerencie 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 Formas SmartArt

Aspose.Slides for Python via .NET permite que você adicione formas SmartArt personalizadas aos slides do zero. A API torna isso fácil. Para adicionar uma forma SmartArt a um slide:

  1. Crie uma instância da classe Apresentação.
  2. Obtenha o slide de destino pelo seu índice.
  3. Adicione uma forma SmartArt, especificando seu tipo de layout.
  4. Salve a apresentação modificada como um arquivo PPTX.
import aspose.slides as slides
import aspose.slides.smartart as smartart

# Instanciar a classe Presentation.
with slides.Presentation() as presentation:
    # Acessar o slide da apresentação.
    slide = presentation.slides[0]
    # Adicionar uma forma SmartArt.
    smart_art = slide.shapes.add_smart_art(0, 0, 400, 400, smartart.SmartArtLayoutType.BASIC_BLOCK_LIST)
    # Salvar a apresentação no disco.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Acessar Formas SmartArt em Slides

O código a seguir demonstra como acessar formas SmartArt em um slide. O exemplo itera por cada forma no slide e verifica se ela é um objeto SmartArt.

import aspose.slides as slides
import aspose.slides.smartart as smartart

# Carregar um arquivo de apresentação.
with slides.Presentation("SmartArt.pptx") as presentation:
    # Iterar por todas as formas no primeiro slide.
    for shape in presentation.slides[0].shapes:
        # Verificar se a forma é uma forma SmartArt.
        if isinstance(shape, smartart.SmartArt):
            # Imprimir o nome da forma.
            print("Shape name:", shape.name)

Acessar Formas SmartArt com um Tipo de Layout Especificado

O exemplo a seguir mostra como acessar uma forma SmartArt com um tipo de layout especificado. Observe que você não pode alterar o tipo de layout de um SmartArt — ele é somente leitura e definido quando a forma é criada.

  1. Crie uma instância de Apresentação e carregue a apresentação que contém a forma SmartArt.
  2. Obtenha uma referência ao primeiro slide pelo índice.
  3. Itere sobre todas as formas no primeiro slide.
  4. Verifique se a forma é um objeto SmartArt.
  5. Se o tipo de layout da forma SmartArt corresponder ao que você precisa, execute as ações necessárias.
import aspose.slides as slides
import aspose.slides.smartart as smartart

with slides.Presentation("SmartArt.pptx") as presentation:
    # Iterar por todas as formas no primeiro slide.
    for shape in presentation.slides[0].shapes:
        # Verificar se a forma é uma forma SmartArt.
        if isinstance(shape, smartart.SmartArt):
            # Verificar o tipo de layout do SmartArt.
            if shape.layout == smartart.SmartArtLayoutType.BASIC_BLOCK_LIST:
                print("Do something here...")

Alterar o Estilo da Forma SmartArt

O exemplo a seguir mostra como localizar formas SmartArt e alterar seu estilo:

  1. Crie uma Apresentação e carregue o arquivo que contém as formas SmartArt.
  2. Obtenha uma referência ao primeiro slide pelo índice.
  3. Itere sobre cada forma no primeiro slide.
  4. Encontre a forma SmartArt com o estilo especificado.
  5. Atribua o novo estilo à forma SmartArt.
  6. Salve a apresentação.
import aspose.slides as slides
import aspose.slides.smartart as smartart

with slides.Presentation("SmartArt.pptx") as presentation:
    # Iterar por todas as formas no primeiro slide.
    for shape in presentation.slides[0].shapes:
        # Verificar se a forma é uma forma SmartArt.
        if isinstance(shape, smartart.SmartArt):
            # Verificar o estilo do SmartArt.
            if shape.quick_style == smartart.SmartArtQuickStyleType.SIMPLE_FILL:
                # Alterar o estilo do SmartArt.
                smart.quick_style = smartart.SmartArtQuickStyleType.CARTOON
    # Salvar a apresentação.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Alterar o Estilo de Cor das Formas SmartArt

Este exemplo mostra como alterar o estilo de cor de uma forma SmartArt. O código de exemplo localiza uma forma SmartArt com um estilo de cor especificado e a atualiza.

  1. Crie uma instância da classe Apresentação e carregue a apresentação que contém as formas SmartArt.
  2. Obtenha uma referência ao primeiro slide pelo índice.
  3. Itere sobre cada forma no primeiro slide.
  4. Verifique se a forma é um objeto SmartArt.
  5. Localize a forma SmartArt com o estilo de cor especificado.
  6. Defina o novo estilo de cor para essa forma SmartArt.
  7. Salve a apresentação.
import aspose.slides as slides
import aspose.slides.smartart as smartart

with slides.Presentation("SmartArt.pptx") as presentation:
    # Iterar por todas as formas no primeiro slide.
    for shape in presentation.slides[0].shapes:
        # Verificar se a forma é uma forma SmartArt.
        if isinstance(shape, smartart.SmartArt):
            # Verificar o tipo de cor.
            if shape.color_style == smartart.SmartArtColorType.COLORED_FILL_ACCENT1:
                # Alterar o tipo de cor.
                shape.color_style = smartart.SmartArtColorType.COLORFUL_ACCENT_COLORS
    # Salvar a apresentação.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Perguntas Frequentes

Posso animar SmartArt como um único objeto?

Sim. SmartArt é uma forma, portanto você pode aplicar animações padrão via a API de animações (entrada, saída, ênfase, trajetórias de movimento) assim como em outras formas.

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

Defina e use o Texto Alternativo (AltText) e procure a forma por esse valor — esta é uma maneira recomendada de localizar a forma alvo.

Posso agrupar SmartArt com outras formas?

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

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 renderizar formas individuais para arquivos raster (PNG/JPG/TIFF).

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

Sim. O mecanismo de renderização visa alta fidelidade para exportação de PDF, 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