Document — Aspose.Note FOSS for Python API Reference
מחלקה: Document
ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import Document ImageRenderOptions: CompositeNode
Document הוא צומת השורש של מודל האובייקטים של מסמך OneNote. הוא מייצג קובץ קטע OneNote יחיד (.one). Document.
ImageRenderOptions
Document(source=None, load_options=None)| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
source | `str | Path | BinaryIO |
load_options | `LoadOptions | None` | ImageRenderOptions |
ImageRenderOptions
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()חריגות שנזרקות על ידי הבונה
| ImageRenderOptions | ImageRenderOptions |
|---|---|
FileCorruptedException | תצורת זמן טעינה אופציונלית |
IncorrectDocumentStructureException | לא ניתן לנתח את הקובץ |
IncorrectPasswordException | מבנה הקובץ אינו נתמך |
UnsupportedFileFormatException | הקובץ מוצפן (הצפנה אינה נתמכת) |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
DisplayName | `str | None` | ImageRenderOptions |
CreationTime | `datetime | None` | ImageRenderOptions |
FileFormat | FileFormat | ImageRenderOptions | חותמת זמן של יצירת הקטע |
ירש מ-CompositeNode
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FirstChild | `Node | None` |
LastChild | `Node | None` |
יורש מ-Node
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
ImageRenderOptions
Count()
len(list(doc)) -> intמחזיר את מספר הילדים הישירים 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 מומש כרגע.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
target | `str | Path |
format_or_options | `SaveFormat | SaveOptions |
ImageRenderOptions:
UnsupportedSaveFormatException: נזרק עבור כלSaveFormatשונה מ-Pdf
הערה על PdfSaveOptions.PageIndex / PageCount: שדות אלה קיימים במחלקת הנתונים אך הם לא מועברים למייצא ה-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.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קוד תואם. אין פעולה.
ImageRenderOptions
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")ראה גם
- ImageRenderOptions: צאצא ישיר של Document
- LoadOptions: אפשרויות בנאי
- PdfSaveOptions: תצורת ייצוא PDF
- DocumentVisitor: מעבר תבנית-מבקר
- מדריך מפתח לייצוא PDF
- How-to: ייצוא OneNote ל-PDF (KB)