Introduzione

Questa guida mostra come creare, modificare e salvare presentazioni PowerPoint in modo programmatico in Python usando Aspose.Slides FOSS. La libreria consente di costruire diapositive da zero, aggiungere e riordinare le diapositive, popolarle con forme, tabelle e testo formattato, e salvare il risultato in PPTX. Tutta l’elaborazione avviene in puro Python senza dipendere da Microsoft Office o da alcun binario esterno.

La libreria è disponibile su PyPI come aspose-slides-foss sotto licenza MIT. Installala con pip, importala e inizia a creare presentazioni in poche righe di codice. Che tu stia automatizzando la generazione di report, costruendo una pipeline di slide o incorporando l’output delle presentazioni in un’applicazione web, il API copre l’intera gamma: collezioni di diapositive, diapositive master/layout, collezioni di forme, riquadri di testo, formati di riempimento e opzioni di esportazione.

Questo post illustra le capacità fondamentali di gestione delle presentazioni — le classi e i metodi che utilizzerai più spesso quando lavori con le diapositive in Python.

Cosa è incluso

Ciclo di vita della presentazione

La classe Presentation è il punto di ingresso. Crea un nuovo deck, manipola il suo contenuto e salva in PPTX. Usa Presentation come gestore di contesto con with per rilasciare automaticamente i handle dei file.

import io
from aspose.slides_foss import Presentation
from aspose.slides_foss.export import SaveFormat

with Presentation() as pres:
    # A new presentation starts with one blank slide
    print("Slides:", len(pres.slides))  # 1

    # Save to a file
    pres.save("output.pptx", SaveFormat.PPTX)

    # Or save to a stream
    buf = io.BytesIO()
    pres.save(buf, SaveFormat.PPTX)

Operazioni sulla Raccolta di Diapositive

SlideCollection ti consente di aggiungere, inserire, clonare, rimuovere e riordinare le diapositive. len(pres.slides) riflette il conteggio corrente dopo ogni modifica.

from aspose.slides_foss import Presentation, ShapeType

with Presentation() as pres:
    layout = pres.layout_slides[0]

    # Add a blank slide using the first layout
    pres.slides.add_empty_slide(layout)

    # Insert at a specific position
    pres.slides.insert_empty_slide(1, layout)

    # Clone an existing slide (shapes are copied)
    pres.slides[0].shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 200, 100)
    pres.slides.add_clone(pres.slides[0])

    print("Total slides:", len(pres.slides))  # 4

    # Remove by index
    pres.slides.remove_at(3)

Forme e AutoShapes

Aggiungi rettangoli, ellissi, triangoli e altre forme geometriche a qualsiasi diapositiva tramite ShapeCollection.add_auto_shape(). Ogni forma espone le proprietà di posizione, dimensione, rotazione e riempimento che persistono tra i cicli di salvataggio/ricarica.

from aspose.slides_foss import Presentation, ShapeType

with Presentation() as pres:
    slide = pres.slides[0]
    slide.shapes.clear()

    rect = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 150)
    rect.rotation = 15

    ellipse = slide.shapes.add_auto_shape(ShapeType.ELLIPSE, 400, 50, 200, 200)

    # Reorder z-index
    slide.shapes.reorder(0, ellipse)
    print("Front shape:", slide.shapes[0].shape_type)  # ELLIPSE

Tabelle

Crea tabelle di dati con ShapeCollection.add_table(), imposta il testo delle celle tramite TextFrame, unisci celle e applica la formattazione dei bordi. L’altezza delle righe e la larghezza delle colonne corrispondono ai valori che passi al costruttore.

from aspose.slides_foss import Presentation, FillType
from aspose.slides_foss.drawing import Color

with Presentation() as pres:
    slide = pres.slides[0]
    slide.shapes.clear()

    table = slide.shapes.add_table(50, 50, [150, 150, 150], [40, 40, 40])

    # Merge two cells in the second row
    table.merge_cells(table.rows[1][0], table.rows[1][1], False)

    # Style the header row with a bottom border
    for col_idx in range(len(table.columns)):
        fmt = table.rows[0][col_idx].cell_format
        fmt.border_bottom.fill_format.fill_type = FillType.SOLID
        fmt.border_bottom.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 0, 0)
        fmt.border_bottom.width = 2

Diapositive Master e Layout

Ogni presentazione ha una gerarchia di diapositive master e diapositive layout. Accedici tramite Presentation.masters e Presentation.layout_slides per applicare una formattazione coerente a tutto il tuo deck.

from aspose.slides_foss import Presentation

with Presentation() as pres:
    master = pres.masters[0]
    print("Master layouts:", len(master.layout_slides))

    # Pick a layout by type
    from aspose.slides_foss import SlideLayoutType
    title_layout = pres.layout_slides.get_by_type(SlideLayoutType.TITLE)
    if title_layout:
        pres.slides.add_empty_slide(title_layout)

Proprietà del documento

Leggi e scrivi i metadati integrati come titolo, autore e soggetto attraverso l’oggetto DocumentProperties. Imposta una di queste proprietà prima di chiamare save() — sono incorporati nei metadati PPTX e leggibili dagli strumenti a valle:

from aspose.slides_foss import Presentation
from aspose.slides_foss.export import SaveFormat

with Presentation() as pres:
    props = pres.document_properties
    props.title = "Quarterly Report"
    props.author = "Engineering"
    props.subject = "Q1 2026 Results"

    pres.save("report.pptx", SaveFormat.PPTX)

Guida rapida

Esegui il seguente comando pip per installare Aspose.Slides FOSS per Python da PyPI:

pip install aspose-slides-foss

Il seguente esempio crea una presentazione con una forma titolo, una tabella dati e un riempimento, quindi la salva in PPTX:

from aspose.slides_foss import Presentation, ShapeType, FillType, NullableBool
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with Presentation() as pres:
    slide = pres.slides[0]
    slide.shapes.clear()

    # Add a title shape
    title = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 30, 860, 80)
    tf = title.add_text_frame("Quarterly Report")
    tf.paragraphs[0].portions[0].portion_format.font_bold = NullableBool.TRUE
    tf.paragraphs[0].portions[0].portion_format.font_height = 28

    # Add a data table
    table = slide.shapes.add_table(50, 150, [200, 200, 200], [40, 40, 40])
    headers = ["Region", "Revenue", "Growth"]
    for i, h in enumerate(headers):
        table.rows[0][i].text_frame.text = h

    # Fill the title shape background
    title.fill_format.fill_type = FillType.SOLID
    title.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 51, 102)

    # Save as PPTX
    pres.save("report.pptx", SaveFormat.PPTX)

Formati supportati

FormatoEstensioneLeggiScrivi
PPTX.pptx✓✓
PPT.ppt—Planned
PPSX.ppsx—Planned
PPTM.pptm—Planned
POTX.potx—Planned
ODP.odp—Planned
PDF.pdf—Planned
HTML.html—Planned
HTML5.html—Planned
TIFF.tiff—Planned
GIF.gif—Planned
XPS.xps—Planned
FODP.fodp—Planned
MD.md—Planned

Nota: La lettura e la scrittura di PPTX sono completamente implementate. Altri SaveFormat i valori (PPT, ODP, PDF, ecc.) sono previsti per le future versioni; passarli a save() attualmente produce output PPTX.

Open Source e Licenze

Aspose.Slides FOSS per Python è rilasciato sotto licenza MIT. Puoi usarlo in progetti personali, accademici e commerciali senza restrizioni. Il codice sorgente è disponibile su GitHub e il pacchetto è pubblicato su PyPI.

Guida introduttiva

Risorse correlate