Przewodnik programisty

Ten przewodnik opisuje podstawowe możliwości Aspose.Slides FOSS dla Pythona wraz z uruchamialnymi przykładami kodu dla każdego obszaru funkcjonalnego.

W tej sekcji

StronaOpis
Funkcje i możliwościPełna lista obsługiwanych funkcji: slajdy, kształty, tekst, wypełnienie, efekty, formatowanie 3D, notatki, komentarze, obrazy i właściwości dokumentu.
Praca z obrazamiOsadzanie obrazów w slajdach jako ramki obrazu z pliku lub bajtów; kontrola trybu wypełnienia (rozciąganie, kafelkowanie).
Praca z łącznikamiDodawanie zgiętych, łokciowych i prostych łączników między kształtami; ustawianie punktów połączeń i stylu linii.
Praca z efektami 3DStosowanie zewnętrznego cienia, poświaty, rozmycia, fazowania, presetów kamery, zestawów świateł i materiałów do kształtów.
Praca z komentarzamiDodawanie wątkowych komentarzy recenzji i notatek prelegenta; zarządzanie autorami komentarzy; odczytywanie adnotacji.

Punkt wejścia API

Każda operacja zaczyna się od obiektu Presentation. Zawsze używaj go jako menedżera kontekstu:

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)

Menadżer kontekstu zapewnia, że wewnętrzne zasoby COM/XML są zwalniane po wyjściu z bloku. Nie przechowuj odwołania Presentation poza blokiem with.

Obsługiwany format wyjściowy

Jedynym obsługiwanym formatem zapisu jest PPTX (SaveFormat.PPTX). Eksport do PDF, HTML, SVG lub formatów obrazów nie jest dostępny w tej edycji.

Kluczowe klasy

Klasa / EnumŚcieżka importuOpis
Presentationaspose.slides_fossGłówny kontener; używany jako menedżer kontekstu
ShapeTypeaspose.slides_fossEnum typów kształtów (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossEnum typów wypełnień (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossTrójstanowa wartość bool dla formatowania (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportEnum formatu wyjściowego (obsługiwany tylko PPTX)
Coloraspose.slides_foss.drawingKonstruktor koloru ARGB
PointFaspose.slides_foss.drawingPunkt 2D zmiennoprzecinkowy (używany do pozycji komentarzy)

Znane ograniczenia

Następujące obszary podnoszą NotImplementedError w tej edycji:

  • Charts: brak tworzenia ani modyfikacji wykresów
  • SmartArt: nieobsługiwane
  • Animations and transitions: przejścia slajdów i animacje obiektów nie mogą być ustawione
  • Export formats: obsługiwane jest tylko zapisywanie w formacie PPTX; brak eksportu do PDF, HTML, SVG ani obrazów
  • Hyperlinks and action settings: obiekty linków nie są modyfikowalne
  • VBA macros and digital signatures: niedostępne

Nieznane części XML napotkane podczas ładowania są zachowywane dosłownie przy zapisie, więc round-tripping nigdy nie usuwa treści, których biblioteka jeszcze nie rozumie.

Zobacz także

 Polski