Szybki start

Szybki start

Ta strona przeprowadza przez podstawowy cykl tworzenia/modyfikacji/zapisywania/ponownego ładowania: buduje dwustronicowy PDF, dołącza adnotację do każdej strony przy użyciu zaktualizowanego Annotation API, generuje widoczną prezentację adnotacji, zapisuje dokument i ponownie go ładuje, aby potwierdzić, że zmiany przetrwały w trakcie cyklu.

Wymagania wstępne

WymaganieSzczegół
Python3.11 lub później
Packageaspose-pdf-foss-for-python zainstalowane (Installation)

1. Utwórz dokument i dodaj strony

Document() bez argumentów tworzy pusty, pamięciowy PDF. document.pages jest mutowalnym PageCollection; wywołanie add() dodaje pustą stronę.

from aspose_pdf import Document

document = Document()
document.pages.add()
document.pages.add()

print("Page count:", document.page_count)

2. Dodaj adnotacje i wygeneruj ich wygląd

Właściwość annotations każdej strony jest AnnotationCollection. add() przyjmuje nazwę podtypu, prostokąt (left, bottom, right, top), tekst treści oraz opcjonalny słownik properties z wartościami kluczowanymi nazwą PDF, zwracając nowy Annotation. generate_appearance() renderuje wizualną zawartość adnotacji, aby wyświetlała się poprawnie w przeglądarce PDF.

document.pages[0].annotations.add("Square", (0, 0, 50, 50), "")

line = document.pages[1].annotations.add(
    "Line", (0, 0, 50, 50), "", properties={"L": [0, 0, 50, 50]}
)
line.generate_appearance()

3. Zapisz i ponownie załaduj

Document.save akceptuje ścieżkę do pliku (lub strumień zapisu). Document.load_from odczytuje dokument z powrotem z ścieżki, bajtów lub strumienia.

document.save("quickstart.pdf")

reopened = Document()
reopened.load_from("quickstart.pdf")

print("Reloaded pages:", reopened.page_count)
print("Has appearance:", reopened.pages[1].annotations[0].has_appearance)

Zobacz także

 Polski