Quickstart
Início rápido
Esta página demonstra o ciclo principal de criar/modificar/salvar/recarregar: construir um PDF de duas páginas, anexar uma anotação a cada página usando a Annotation API atualizada, gerar a aparência visível das anotações, salvar o documento e recarregá‑lo para confirmar que as alterações sobreviveram ao percurso.
Pré-requisitos
| Requisito | Detalhe |
|---|---|
| Python | 3.11 ou posterior |
| Package | aspose-pdf-foss-for-python instalado (Installation) |
1. Crie um documento e adicione páginas
Document() sem argumentos cria um PDF vazio em memória. document.pages é um PageCollection mutável; chamar add() adiciona uma página em branco.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. Adicione anotações e gere sua aparência
A propriedade annotations de cada página é um AnnotationCollection. add() recebe um nome de subtipo, um retângulo (left, bottom, right, top), texto de conteúdo e um dicionário opcional properties de valores indexados por nomes PDF, retornando o novo Annotation. generate_appearance() renderiza o conteúdo visual da anotação para que seja exibido corretamente em um visualizador de 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. Salvar e recarregar
Document.save aceita um caminho de arquivo (ou um fluxo gravável). Document.load_from lê um documento de volta a partir de um caminho, bytes ou fluxo.
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)