Document

Document — Aspose.Note FOSS for Python API Reference

Clase: Document

Examples: aspose.note Examples: from aspose.note import Document Examples: CompositeNode

Document es el nodo raíz del modelo de objetos del documento OneNote. Representa un único archivo de sección de OneNote (.one). Todas las páginas son hijos directos de Document.

Examples

Document(source=None, load_options=None)

Examples	Examples	Examples	Examples
`source`	`str	Path	BinaryIO
`load_options`	`LoadOptions	None`	Examples

Examples

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()

Excepciones lanzadas por el constructor

Examples	Examples
`FileCorruptedException`	El archivo no se puede analizar
`IncorrectDocumentStructureException`	La estructura del archivo no es compatible
`IncorrectPasswordException`	El archivo está cifrado (cifrado no compatible)
`UnsupportedFileFormatException`	El formato del archivo no se reconoce

Examples

Examples	Examples	Examples	Examples
`DisplayName`	`str	None`	Examples
`CreationTime`	`datetime	None`	Examples
`FileFormat`	`FileFormat`	Examples	Indicador de mejor esfuerzo de la versión del formato de archivo OneNote

Heredado de CompositeNode

Examples	Examples	Examples
`FirstChild`	`Node	None`
`LastChild`	`Node	None`

Hereda de Node

Examples	Examples	Examples
`ParentNode`	`Node	None`
`Document`	`Document	None`

Examples

Count()

len(list(doc)) -> int

Devuelve el número de hijos directos Page nodos (es decir, el número de páginas en la sección).

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

Guarda el documento en una ruta de archivo, pathlib.Path, o un flujo binario. Solo SaveFormat.Pdf está implementado actualmente.

Examples	Examples	Examples
`target`	`str	Path
`format_or_options`	`SaveFormat	SaveOptions

Examples:

UnsupportedSaveFormatException: lanzado para cualquier SaveFormat distinto de Pdf

Nota sobre PdfSaveOptions.PageIndex / PageCount: Estos campos existen en la dataclass pero son no enviados al exportador PDF en v26.3.1 y no tienen efecto. El documento completo siempre se exporta.

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

Despacha al visitante para recorrer todo el árbol del documento. Llama visitor.VisitDocumentStart(self), luego visita recursivamente todos los nodos hijos.

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]

Devuelve el historial de versiones de una página. En la v26.3.1, esto es un stub de compatibilidad que devuelve [page].

DetectLayoutChanges()

doc.DetectLayoutChanges() -> None

Stub de compatibilidad. No realiza ninguna operación.

Examples

for page in doc:
    ...

Itera el hijo directo Page nodos en orden de documento.

Ejemplo completo

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")

Ver también

Examples: hijo directo de Document
LoadOptions: opciones del constructor
PdfSaveOptions: configuración de exportación PDF
DocumentVisitor: recorrido del patrón visitor
Guía del desarrollador de exportación PDF
Cómo hacerlo: Exportar OneNote a PDF (KB)