Document — Aspose.Note FOSS for Python API Reference
คลาส: Document
Properties: aspose.note Properties: from aspose.note import Document Properties: CompositeNode
Document เป็นโหนดรากของโมเดลวัตถุเอกสาร OneNote. มันแทนไฟล์ส่วนของ OneNote หนึ่งไฟล์ (.one). หน้าทั้งหมดเป็นลูกโดยตรงของ Document.
Properties
Document(source=None, load_options=None)| Properties | Properties | Properties | Properties |
|---|---|---|---|
source | `str | Path | BinaryIO |
load_options | `LoadOptions | None` | Properties |
Properties
from aspose.note import Document
##Load from a file path
doc = Document("MyNotes.one")
##Load from a binary stream
with open("MyNotes.one", "rb") as f:
doc = Document(f)
##Empty document (no source file)
doc = Document()ข้อยกเว้นที่เกิดจากคอนสตรัคเตอร์
| Properties | Properties |
|---|---|
FileCorruptedException | ไม่สามารถแยกวิเคราะห์ไฟล์ได้ |
IncorrectDocumentStructureException | โครงสร้างไฟล์ไม่รองรับ |
IncorrectPasswordException | ไฟล์ถูกเข้ารหัส (การเข้ารหัสไม่รองรับ) |
UnsupportedFileFormatException | ไม่รู้จักรูปแบบไฟล์ |
Properties
| Properties | Properties | Properties | Properties |
|---|---|---|---|
DisplayName | `str | None` | Properties |
CreationTime | `datetime | None` | Properties |
FileFormat | FileFormat | Properties | การบ่งชี้เวอร์ชันรูปแบบไฟล์ OneNote อย่างดีที่สุดที่ทำได้ |
สืบทอดจาก CompositeNode
| Properties | Properties | Properties |
|---|---|---|
FirstChild | `Node | None` |
LastChild | `Node | None` |
สืบทอดจาก Node
| Properties | Properties | Properties |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
Properties
Count()
len(list(doc)) -> intคืนค่าจำนวน child โดยตรง Page โหนด (เช่น จำนวนหน้าในส่วน).
from aspose.note import Document
doc = Document("MyNotes.one")
print(f"Pages: {len(list(doc))}")Save(target, format_or_options)
doc.Save(target: str | Path | BinaryIO, format_or_options: SaveFormat | SaveOptions | None = None) -> Noneบันทึกเอกสารไปยังเส้นทางไฟล์, pathlib.Path, หรือสตรีมไบนารี. เท่านั้น SaveFormat.Pdf ในปัจจุบันได้ถูกนำไปใช้.
| Properties | Properties | Properties |
|---|---|---|
target | `str | Path |
format_or_options | `SaveFormat | SaveOptions |
Properties:
UnsupportedSaveFormatException: ถูกยกขึ้นสำหรับใด ๆSaveFormatนอกจากPdf
หมายเหตุเกี่ยวกับ PdfSaveOptions.PageIndex / PageCount: ฟิลด์เหล่านี้มีอยู่ใน dataclass แต่ ไม่ได้ส่งต่อไปยังตัวส่งออก PDF ในเวอร์ชัน v26.3.1 และไม่มีผลกระทบ. เอกสารเต็มจะถูกส่งออกเสมอ.
import io
from aspose.note import Document, SaveFormat, PdfSaveOptions
doc = Document("MyNotes.one")
##Save to file path (string)
doc.Save("output.pdf", SaveFormat.Pdf)
##Save to a pathlib.Path
from pathlib import Path
doc.Save(Path("output.pdf"), SaveFormat.Pdf)
##Save to an in-memory stream
buf = io.BytesIO()
doc.Save(buf, PdfSaveOptions(SaveFormat.Pdf))
pdf_bytes = buf.getvalue()Accept(visitor)
doc.Accept(visitor: DocumentVisitor) -> Noneส่งมอบ visitor เพื่อสำรวจต้นไม้เอกสารทั้งหมด. เรียก visitor.VisitDocumentStart(self), จากนั้นทำการเยี่ยมชมโหนดลูกทั้งหมดแบบเรียกซ้ำ.
from aspose.note import Document, DocumentVisitor
class MyVisitor(DocumentVisitor):
def VisitDocumentStart(self, doc):
print(f"Document: {doc.DisplayName}")
doc = Document("MyNotes.one")
doc.Accept(MyVisitor())GetPageHistory(page)
doc.GetPageHistory(page: Page) -> list[Page]คืนประวัติเวอร์ชันของหน้า. ใน v26.3.1, นี่คือสตับความเข้ากันได้ที่คืนค่า [page].
DetectLayoutChanges()
doc.DetectLayoutChanges() -> Noneสตับความเข้ากันได้. ไม่มีการดำเนินการ.
Properties
for page in doc:
...วนซ้ำลูกโดยตรง Page โหนดในลำดับเอกสาร.
ตัวอย่างเต็ม
from aspose.note import Document, Page, RichText, SaveFormat
doc = Document("MyNotes.one")
print(f"Section: {doc.DisplayName}")
print(f"Format: {doc.FileFormat}")
print(f"Created: {doc.CreationTime}")
print(f"Pages: {len(list(doc))}")
for page in doc:
title = page.Title.TitleText.Text if page.Title and page.Title.TitleText else "(untitled)"
texts = page.GetChildNodes(RichText)
print(f" [{title}] {len(texts)} text node(s)")
doc.Save("output.pdf", SaveFormat.Pdf)
print("Saved output.pdf")ดูเพิ่มเติม
- Properties: ลูกโดยตรงของ Document
- LoadOptions: ตัวเลือกของคอนสตรัคเตอร์
- PdfSaveOptions: การกำหนดค่าการส่งออก PDF
- DocumentVisitor: การท่องผ่านแบบ Visitor Pattern
- คู่มือผู้พัฒนา PDF Export
- วิธีทำ: ส่งออก OneNote เป็น PDF (KB)