Entwicklerhandbuch
Dieser Leitfaden behandelt die Kernfunktionen von Aspose.Slides FOSS für Python mit ausführbaren Codebeispielen für jeden Funktionsbereich.
In diesem Abschnitt
| Seite | Beschreibung |
|---|---|
| Features and Capabilities | Vollständige Liste der unterstützten Funktionen: Folien, Formen, Text, Füllung, Effekte, 3D-Formatierung, Notizen, Kommentare, Bilder und Dokumenteigenschaften. |
| Working with Images | Bilder in Folien als Bildrahmen aus Datei oder Bytes einbetten; Füllmodus (Strecken, Kacheln) steuern. |
| Working with Connectors | Gebogene, Ellenbogen- und gerade Verbindungen zwischen Formen hinzufügen; Verbindungsstellen und Linienstil festlegen. |
| Working with 3D Effects | Äußeren Schatten, Leuchten, Unschärfe, Abschrägung, Kamera‑Voreinstellungen, Lichtanlagen und Materialien auf Formen anwenden. |
| Working with Comments | Threaded Review‑Kommentare und Sprecher‑Notizen hinzufügen; Kommentarautoren verwalten; Anmerkungen lesen. |
API-Einstiegspunkt
Jeder Vorgang beginnt mit einem Presentation‑Objekt. Verwenden Sie es immer als Kontextmanager:
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)Der Kontextmanager stellt sicher, dass interne COM/XML‑Ressourcen freigegeben werden, wenn der Block beendet wird. Speichern Sie keine Presentation‑Referenz außerhalb des with‑Blocks.
Unterstütztes Ausgabeformat
Das einzige unterstützte Speicherformat ist PPTX (SaveFormat.PPTX). Der Export zu PDF, HTML, SVG oder Bildformaten ist in dieser Ausgabe nicht verfügbar.
Schlüsselklassen
| Klasse / Aufzählung | Importpfad | Beschreibung |
|---|---|---|
Presentation | aspose.slides_foss | Root-Container; als Kontextmanager verwenden |
ShapeType | aspose.slides_foss | Enum für Formtypen (RECTANGLE, ELLIPSE, …) |
FillType | aspose.slides_foss | Enum für Fülltypen (SOLID, GRADIENT, …) |
NullableBool | aspose.slides_foss | Tri-State-Bool für Formatierung (TRUE, FALSE, NOT_DEFINED) |
SaveFormat | aspose.slides_foss.export | Ausgabeformat-Enum (nur PPTX unterstützt) |
Color | aspose.slides_foss.drawing | ARGB-Farbkonstruktor |
PointF | aspose.slides_foss.drawing | Float-2D-Punkt (verwendet für Kommentarpositionen) |
Bekannte Einschränkungen
Die folgenden Bereiche lösen NotImplementedError in dieser Ausgabe aus:
- Diagramme: keine Diagrammerstellung oder -bearbeitung
- SmartArt: nicht unterstützt
- Animationen und Übergänge: Folienübergänge und Objektanimationen können nicht festgelegt werden
- Exportformate: Nur das Speichern als PPTX wird unterstützt; kein PDF, HTML, SVG oder Bildexport
- Hyperlinks und Aktions‑Einstellungen: Verknüpfungsobjekte sind nicht bearbeitbar
- VBA‑Makros und digitale Signaturen: nicht zugänglich
Unbekannte XML‑Teile, die beim Laden gefunden werden, werden beim Speichern unverändert beibehalten, sodass beim Round‑Trip nie Inhalte entfernt werden, die die Bibliothek noch nicht versteht.
Siehe auch
- Erste Schritte: Installation und erstes Skript
- API-Referenz: Klassen- und Methodenreferenz
- Anleitungen: Aufgabenorientierte How‑To‑Artikel