Guida per sviluppatori

Questa guida copre le funzionalità principali di Aspose.Slides FOSS per Python con esempi di codice eseguibili per ogni area funzionale.

In questa sezione

PageDescription
Funzionalità e capacitàElenco completo delle funzionalità supportate: diapositive, forme, testo, riempimento, effetti, formattazione 3D, note, commenti, immagini e proprietà del documento.
Lavorare con le immaginiIncorpora immagini nelle diapositive come riquadri immagine da file o byte; controlla la modalità di riempimento (allungamento, tassellatura).
Lavorare con i connettoriAggiungi connettori curvi, a gomito e dritti tra le forme; imposta i punti di connessione e lo stile della linea.
Lavorare con gli effetti 3DApplica ombra esterna, bagliore, sfocatura, smussatura, preset della fotocamera, set di luci e materiali alle forme.
Lavorare con i commentiAggiungi commenti di revisione in thread e note del relatore; gestisci gli autori dei commenti; leggi le annotazioni.

Punto di ingresso API

Ogni operazione inizia con un oggetto Presentation. Usalo sempre come gestore di contesto:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

Il gestore di contesto garantisce che le risorse interne COM/XML vengano rilasciate quando il blocco termina. Non memorizzare un riferimento Presentation al di fuori del blocco with.

Formato di output supportato

L’unico formato di salvataggio supportato è PPTX (SaveFormat.PPTX). L’esportazione in PDF, HTML, SVG o formati immagine non è disponibile in questa edizione.

Classi chiave

Classe / EnumPercorso di importazioneDescrizione
Presentationaspose.slides_fossContenitore radice; da usare come gestore di contesto
ShapeTypeaspose.slides_fossEnum per i tipi di forma (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossEnum per i tipi di riempimento (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossBooleano a tre stati per la formattazione (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportEnum del formato di output (solo PPTX supportato)
Coloraspose.slides_foss.drawingCostruttore di colore ARGB
PointFaspose.slides_foss.drawingPunto 2D in virgola mobile (usato per le posizioni dei commenti)

Limitazioni note

Le seguenti aree generano NotImplementedError in questa edizione:

  • Charts: nessuna creazione o modifica di grafici
  • SmartArt: non supportato
  • Animations and transitions: le transizioni delle diapositive e le animazioni degli oggetti non possono essere impostate
  • Export formats: è supportato solo il salvataggio PPTX; nessun esportazione in PDF, HTML, SVG o immagine
  • Hyperlinks and action settings: gli oggetti collegamento non sono modificabili
  • VBA macros and digital signatures: non accessibili

Le parti XML sconosciute incontrate durante il caricamento vengono preservate alla lettera al salvataggio, quindi il round‑tripping non rimuove mai contenuti che la libreria non comprende ancora.

Vedi anche

 Italiano