Gestionar formas en presentaciones usando Python

Visión general

Esta guía introduce la manipulación de formas en Aspose.Slides para Python mediante .NET. Aprenda patrones prácticos para encontrar formas (incluido por Texto Alternativo), duplicar, eliminar u ocultar, reordenar, alinear y voltear, leer IDs y formato guiado por el diseño, y exportar formas individuales a SVG usando las API de Presentation y Shape.

Buscar formas en diapositivas

PowerPoint identifica las formas solo por IDs internos. Asigne un Texto Alternativo único a la forma objetivo en PowerPoint, luego abra la presentación con Aspose.Slides para Python, recorra las formas de la diapositiva y seleccione la que coincida con el Texto Alternativo. El método find_shape implementa este enfoque y devuelve la forma coincidente.

import aspose.slides as slides

# Busca una forma en una diapositiva por su texto alternativo.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# Instancia la clase Presentation que representa un archivo de presentación.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Encuentra la forma con Alt Text "Shape1".
    shape = find_shape(slide, "Shape1")
    if shape is not None:
        print("Shape name:", shape.name)

Clonar formas

Para clonar formas de una diapositiva origen a una nueva diapositiva en Aspose.Slides, siga estos pasos:

  1. Cree una Presentation a partir del archivo origen.
  2. Obtenga la diapositiva origen por índice y su colección de formas.
  3. Recupere un diseño en blanco de la diapositiva maestra.
  4. Añada una diapositiva vacía usando ese diseño y obtenga sus formas.
  5. Clone las formas en la diapositiva destino.
  6. Guarde la presentación como PPTX.

El siguiente ejemplo de código clona formas de una diapositiva a otra.

import aspose.slides as slides

# Instanciar la clase Presentation.
with slides.Presentation("sample.pptx") as presentation:
    source_shapes = presentation.slides[0].shapes
    blank_layout = presentation.masters[0].layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    target_slide = presentation.slides.add_empty_slide(blank_layout)
    target_shapes = target_slide.shapes

    target_shapes.add_clone(source_shapes[1], 50, 150 + source_shapes[0].height)
    target_shapes.add_clone(source_shapes[2])
    target_shapes.insert_clone(0, source_shapes[0], 50, 150)

    # Guardar la presentación en disco.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Eliminar formas

Aspose.Slides le permite eliminar cualquier forma de una diapositiva. Por ejemplo, para borrar una forma de la primera diapositiva por su Texto Alternativo, siga estos pasos:

  1. Cree una instancia de Presentation y cargue el archivo.
  2. Acceda a la primera diapositiva de la colección de diapositivas.
  3. Encuentre la forma por el valor del Texto Alternativo.
  4. Elimine la forma de la colección de formas de la diapositiva.
  5. Guarde la presentación en disco en formato PPTX.
import aspose.slides as slides

# Busca una forma en una diapositiva por su texto alternativo.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# Instancia la clase Presentation que representa un archivo de presentación.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Busca la forma con Alt Text "User Defined".
    shape = find_shape(slide, "User Defined")
    # Elimina la forma.
    slide.shapes.remove(shape)
    # Guarda la presentación en disco.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Ocultar formas

Aspose.Slides le permite ocultar cualquier forma en una diapositiva. Por ejemplo, para ocultar una forma en la primera diapositiva por su Texto Alternativo, siga estos pasos:

  1. Cree una instancia de Presentation y cargue el archivo.
  2. Acceda a la primera diapositiva de la colección de diapositivas.
  3. Encuentre la forma por el valor del Texto Alternativo.
  4. Oculte la forma.
  5. Guarde la presentación en disco en formato PPTX.
# Busca una forma en una diapositiva por su texto alternativo.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# Instancia la clase Presentation que representa un archivo de presentación.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Busca la forma con Alt Text "User Defined".
    shape = find_shape(slide, "User Defined")
    # Oculta la forma.
    shape.hidden = True
    # Guarda la presentación en disco.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Cambiar el orden de las formas

Aspose.Slides permite a los desarrolladores reordenar formas (cambiar su orden z). El reordenamiento determina qué forma aparece delante o detrás. Por ejemplo, para reordenar dos formas en la primera diapositiva, siga los pasos a continuación:

  1. Cree una instancia de la clase Presentation.
  2. Acceda a la primera diapositiva.
  3. Añada la primera forma (por ejemplo, un rectángulo).
  4. Añada la segunda forma (por ejemplo, un triángulo).
  5. Reordene las formas moviendo la segunda forma a la primera posición en la colección.
  6. Guarde la presentación en disco.
import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Añadir dos formas a la diapositiva.
    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 200, 150)
    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.TRIANGLE, 20, 200, 200, 150)
    # Mover la segunda forma a la primera posición.
    slide.shapes.reorder(0, shape2)
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Obtener el ID de forma Interop

Aspose.Slides le permite obtener el identificador único de una forma en el ámbito de la diapositiva, a diferencia de la propiedad unique_id, que es única en toda la presentación. La propiedad office_interop_shape_id está disponible en la clase Shape. Su valor corresponde al Id del objeto Microsoft.Office.Interop.PowerPoint.Shape. A continuación se muestra un fragmento de código de ejemplo.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    # Obtener el identificador único de la forma dentro de la diapositiva.
    officeInteropShapeId = presentation.slides[0].shapes[0].office_interop_shape_id

Establecer el texto alternativo para las formas

Aspose.Slides permite a los desarrolladores establecer texto alternativo para cualquier forma. Puede usar el texto alternativo para identificar y localizar formas en una presentación. La propiedad de texto alternativo puede leerse y modificarse tanto a través de Aspose.Slides como de Microsoft PowerPoint. Al etiquetar las formas con esta propiedad, podrá eliminarlas, ocultarlas o reordenarlas posteriormente en una diapositiva.

Para establecer el texto alternativo de una forma, siga estos pasos:

  1. Cree una instancia de la clase Presentation.
  2. Acceda a la primera diapositiva.
  3. Añada una forma a la diapositiva.
  4. Establezca el texto alternativo.
  5. Guarde la presentación en disco.
import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo PPTX.
with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    # Añadir una forma.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 40, 150, 50)
    # Establecer el texto alternativo de la forma.
    shape.alternative_text = "User Defined"
    # Guardar la presentación en disco.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Acceder a formatos de diseño para las formas

Aspose.Slides proporciona una API simple para acceder a los formatos de diseño de las formas. Esta sección muestra cómo acceder a dichos formatos.

import aspose.slides as slides

with slides.Presentation(folder_path + "sample.pptx") as presentation:
    for layout_slide in presentation.layout_slides:
        fill_formats = list(map(lambda shape: shape.fill_format, layout_slide.shapes))
        line_formats = list(map(lambda shape: shape.line_format, layout_slide.shapes))

Renderizar formas como SVG

Aspose.Slides admite la renderización de formas como SVG. El método write_as_svg (y sus sobrecargas) en la clase Shape le permite guardar el contenido de una forma como una imagen SVG. El fragmento de código a continuación muestra cómo exportar una forma a un archivo SVG.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    with open("output.svg", "wb") as image_stream:
        # Obtener la primera forma en la primera diapositiva.
        shape = presentation.slides[0].shapes[0]
        shape.write_as_svg(image_stream)

Alinear forma

Usando el método align_shape en la clase SlidesUtil, puede:

  • Alinear formas respecto a los márgenes de una diapositiva (ver Ejemplo 1).
  • Alinear formas respecto a otras (ver Ejemplo 2).

La enumeración ShapesAlignmentType define las opciones de alineación disponibles.

Ejemplo 1

Este código Python muestra cómo alinear las formas con índices 1, 2 y 4 al borde superior de la diapositiva:

import aspose.slides as slides

align_type = slides.ShapesAlignmentType.ALIGN_TOP
slide_indices = [1, 2, 4]

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    slides.util.SlideUtil.align_shapes(align_type, True, slide, slide_indices)

Ejemplo 2

Este ejemplo Python muestra cómo alinear todas las formas de una colección respecto a la forma más baja de esa colección:

import aspose.slides as slides

align_type = slides.ShapesAlignmentType.ALIGN_BOTTOM

with slides.Presentation("sample.pptx") as presentation:
    slides.util.SlideUtil.align_shapes(align_type, False, presentation.slides[0])

Propiedades de volteo

En Aspose.Slides, la clase ShapeFrame proporciona control sobre el espejo horizontal y vertical de las formas mediante sus propiedades flip_h y flip_v. Ambas propiedades son del tipo NullableBool, permitiendo valores TRUE para indicar un volteo, FALSE para no voltear, o NOT_DEFINED para usar el comportamiento predeterminado. Estos valores son accesibles desde el Frame de una forma.

Para modificar la configuración de volteo, se construye una nueva instancia de ShapeFrame con la posición y tamaño actuales de la forma, los valores deseados para flip_h y flip_v, y el ángulo de rotación. Asignar esta instancia al Frame de la forma y guardar la presentación aplica las transformaciones de espejo y las grava en el archivo de salida.

Supongamos que tenemos un archivo sample.pptx en el que la primera diapositiva contiene una única forma con la configuración de volteo predeterminada, como se muestra a continuación.

The shape to be flipped

El siguiente ejemplo de código recupera las propiedades de volteo actuales de la forma y la voltea tanto horizontal como verticalmente.

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    # Recuperar la propiedad de volteo horizontal de la forma.
    horizontal_flip = shape.frame.flip_h
    print("Horizontal flip:", horizontal_flip)

    # Recuperar la propiedad de volteo vertical de la forma.
    vertical_flip = shape.frame.flip_v
    print("Vertical flip:", vertical_flip)

    x, y = shape.frame.x, shape.frame.y
    width, height = shape.frame.width, shape.frame.height
    flip_h, flip_v = slides.NullableBool.TRUE, slides.NullableBool.TRUE  # Voltear horizontal y verticalmente.
    rotation = shape.frame.rotation

    shape.frame = slides.ShapeFrame(x, y, width, height, flip_h, flip_v, rotation)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The flipped shape

Preguntas frecuentes

¿Puedo combinar formas (unión/intersección/resta) en una diapositiva como en un editor de escritorio?

No existe una API de operación booleanas incorporada. Puede aproximarse construyendo el contorno deseado usted mismo—p. ej., calcule la geometría resultante (mediante GeometryPath) y cree una nueva forma con ese contorno, opcionalmente eliminando las originales.

¿Cómo puedo controlar el orden de apilamiento (z-order) para que una forma siempre quede “encima”?

Cambie el orden de inserción/movimiento dentro de la colección shapes de la diapositiva. Para resultados predecibles, finalice el z-order después de todas las demás modificaciones de la diapositiva.

¿Puedo “bloquear” una forma para evitar que los usuarios la editen en PowerPoint?

Sí. Establezca los banderas de protección a nivel de forma (p. ej., bloquear selección, movimiento, cambio de tamaño, edición de texto). Si es necesario, replique las restricciones en la diapositiva maestra o de diseño. Tenga en cuenta que esta es una protección a nivel de UI, no una característica de seguridad; para una protección más robusta, combínela con restricciones a nivel de archivo como recomendaciones de solo lectura o contraseñas.

Efecto de Forma Obtener propiedades efectivas de formas en presentaciones con Python