Quickstart
Început rapid
Această pagină parcurge ciclul de bază creare/modificare/salvare/încărcare: construiește un PDF de două pagini, atașează o adnotare fiecărei pagini utilizând Annotation API actualizat, generează aspectul vizibil al adnotărilor, salvează documentul și îl încarcă din nou pentru a confirma că modificările au supraviețuit procesului de round‑trip.
Precondiții
| Cerință | Detaliu |
|---|---|
| Python | 3.11 sau ulterior |
| Package | aspose-pdf-foss-for-python instalat (Installation) |
1. Creează un document și adaugă pagini
Document() fără argumente creează un PDF gol, în memorie. document.pages este un PageCollection mutabil; apelarea lui add() adaugă o pagină goală.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. Adaugă adnotări și generează aspectul lor
Proprietatea annotations a fiecărei pagini este un AnnotationCollection. add() primește un nume de subtip, un dreptunghi (left, bottom, right, top), textul conținutului și un dicționar opțional properties de valori indexate după nume PDF, returnând noul Annotation. generate_appearance() redă conținutul vizual al adnotării pentru a se afișa corect într-un vizualizator 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. Salvează și reîncarcă
Document.save acceptă o cale de fișier (sau un flux scriibil). Document.load_from citește un document înapoi dintr-o cale, octeți sau flux.
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)