Quickstart
เริ่มต้นอย่างรวดเร็ว
หน้านี้อธิบายขั้นตอนหลักของการสร้าง/แก้ไข/บันทึก/โหลดใหม่: สร้าง PDF สองหน้า, แนบคำอธิบายลงในแต่ละหน้าโดยใช้ Annotation ที่อัปเดต API, สร้างลักษณะการแสดงผลที่มองเห็นได้ของคำอธิบาย, บันทึกเอกสาร, และโหลดใหม่เพื่อยืนยันว่าการเปลี่ยนแปลงยังคงอยู่หลังการเดินทางรอบหนึ่ง.
ข้อกำหนดเบื้องต้น
| ข้อกำหนด | รายละเอียด |
|---|---|
| Python | 3.11 หรือใหม่กว่า |
| Package | aspose-pdf-foss-for-python ติดตั้งแล้ว (Installation) |
1. สร้างเอกสารและเพิ่มหน้า
Document() โดยไม่มีอาร์กิวเมนต์จะสร้าง PDF ที่ว่างเปล่าในหน่วยความจำ. document.pages เป็น PageCollection ที่เปลี่ยนแปลงได้; การเรียก add() จะเพิ่มหน้าว่าง.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. เพิ่มคำอธิบายและสร้างลักษณะการแสดงผลของมัน
คุณสมบัติ annotations ของแต่ละหน้าคือ AnnotationCollection. add() รับชื่อชนิดย่อย, สี่เหลี่ยม (left, bottom, right, top), ข้อความเนื้อหา, และอ็อบเจกต์ properties ตัวเลือกที่เป็นพจนานุกรมของค่าที่มีคีย์เป็นชื่อ PDF, แล้วคืนค่า Annotation ใหม่. generate_appearance() ทำการเรนเดอร์เนื้อหาภาพของคำอธิบายเพื่อให้แสดงอย่างถูกต้องในโปรแกรมดู 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. บันทึกและโหลดใหม่
Document.save ยอมรับเส้นทางไฟล์ (หรือสตรีมที่เขียนได้). Document.load_from อ่านเอกสารกลับจากเส้นทาง, ไบต์, หรือสตรีม.
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)