Formas de Apresentação em Grupo com Python

Visão geral

Este artigo explica como trabalhar com formas de grupo no Aspose.Slides. Ele mostra como adicionar uma forma de grupo a um slide, colocar formas dentro dela e salvar a apresentação atualizada. Também demonstra como acessar as formas armazenadas dentro de um grupo e ler seus valores alternative_text. Além disso, o artigo aborda brevemente recursos relacionados a formas de grupo, como grupos aninhados, ordem Z e opções de bloqueio.

Adicionar formas de grupo

O Aspose.Slides oferece suporte ao trabalho com formas de grupo em um slide. Esse recurso permite criar apresentações mais ricas tratando várias formas como um único objeto. Você pode adicionar novas formas de grupo, acessar as existentes, preenchê-las com formas filhas e ler ou modificar quaisquer de suas propriedades. Para adicionar uma forma de grupo a um slide:

1. Crie uma instância da classe Presentation.
2. Obtenha uma referência a um slide por índice.
3. Adicione um GroupShape ao slide.
4. Adicione formas à nova forma de grupo.
5. Salve a apresentação modificada como um arquivo PPTX.

O exemplo abaixo mostra como adicionar uma forma de grupo a um slide.

import aspose.slides as slides

# Instanciar a classe Presentation.
with slides.Presentation() as presentation:
    # Obter o primeiro slide.
    slide = presentation.slides[0]

    # Adicionar uma forma de grupo ao slide.
    group_shape = slide.shapes.add_group_shape()

    # Adicionar formas dentro da forma de grupo.
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 100, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 100, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 300, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 300, 100, 100)

    # Gravar o arquivo PPTX no disco.
    presentation.save("group_shape.pptx", slides.export.SaveFormat.PPTX)

Acessar a propriedade Alt Text

Esta seção explica como ler o Alt Text das formas contidas dentro de uma forma de grupo em um slide usando o Aspose.Slides. Para acessar o Alt Text das formas:

1. Instancie a classe Presentation para representar um arquivo PPTX.
2. Obtenha uma referência ao slide pelo seu índice.
3. Acesse a coleção de formas do slide.
4. Acesse o GroupShape.
5. Leia a propriedade Alt Text.

O exemplo abaixo recupera o Alt Text das formas contidas dentro de formas de grupo.

import aspose.slides as slides

# Instanciar a classe Presentation para abrir o arquivo PPTX.
with slides.Presentation("group_shape.pptx") as presentation:
    # Obter o primeiro slide.
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if isinstance(shape, slides.GroupShape):
            # Acessar a forma de grupo.
            for child_shape in shape.shapes:
                # Acessar a propriedade Alt Text.
                print(child_shape.alternative_text)

Perguntas frequentes

É o agrupamento aninhado (um grupo dentro de outro grupo) suportado?

Sim. O GroupShape possui a propriedade parent_group, que indica diretamente o suporte à hierarquia (um grupo pode ser filho de outro grupo).

Como controlar a ordem Z do grupo em relação a outros objetos no slide?

Use a propriedade z_order_position do GroupShape para verificar sua posição na pilha de exibição.

Posso impedir mover/editar/desagrupar?

Sim. A seção de bloqueio do grupo é exposta através de group_shape_lock, que permite restringir operações no objeto.