Aspose.Note FOSS for Python

Ova referenca pokriva kompletnu javnu API površinu aspose-note verzija 26.3.1. Samo simboli izvezeni iz aspose.note paketa su dokumentovani ovde. Sve što je pod aspose.note._internal je detalj implementacije i može se promeniti bez najave.

: pip install aspose-note (core) ili pip install "aspose-note[pdf]" (sa PDF izvozom)

: from aspose.note import Document, RichText, ...

Dokument i pretraga


`Document`	Root objekat dokumenta. Učitaj `.one` datoteku, iteriraj stranice i sačuvaj u PDF.
`DocumentVisitor`	Apstraktna baza za obilazak stabla dokumenta po obrascu posetioca.
`Node`	Osnovna klasa za sve čvorove dokumenta.
`CompositeNode`	Osnovna klasa za čvorove koji mogu da sadrže podčvorove.

Struktura dokumenta


`Page`	Predstavlja OneNote stranicu.
`Title`	Blok naslova stranice koji sadrži TitleText, TitleDate, TitleTime.
`Outline`	Pozicioni kontejner za OutlineElement čvorove.
`OutlineElement`	Listni kontejner; sadrži RichText, Image, Table, AttachedFile.


`RichText`	Tekstualni blok sa formatiranim delovima, oznakama i hipervezama.
`TextRun`	Jedinstveni formatirani tekstualni segment unutar RichText-a.
`TextStyle`	Svojstva formatiranja za TextRun.
`Image`	Ugrađena slika sa sirovim bajtovima i metapodacima.
`AttachedFile`	Ugrađeni fajl prilog sa sirovim bajtovima.
`Table`	Tabela sa redovima, ćelijama i širinama kolona.
`TableRow`	Red unutar tabele.
`TableCell`	Ćelija unutar TableRow-a; sadrži čvorove sadržaja.
`NoteTag`	OneNote oznaka (zvezda, polje za potvrdu, itd.) prikačena na čvor sadržaja.
`NumberList`	Metapodaci numerisane liste na OutlineElement-u.


`LoadOptions`	Opcije za učitavanje `.one` datoteke.
`SaveOptions`	Osnovna klasa za opcije čuvanja.
`PdfSaveOptions`	PDF‑specifične opcije čuvanja (ikone oznaka).

Stubovi kompatibilnosti


`License`	Kompatibilni stub: `SetLicense()` je no‑op u ovoj FOSS implementaciji.
`Metered`	Kompatibilni stub: `SetMeteredKey()` je no-op u ovoj FOSS implementaciji.

Detalji klase

Osnovna klasa dokumenta. Učitajte .one datoteku iz putanje do datoteke, a pathlib.Path, ili binarni tok.

from aspose.note import Document, LoadOptions

doc = Document(source=None, load_options=None)

Parametri konstruktora:


`source`	`str	Path
`load_options`	`LoadOptions	None`


`DisplayName`	`str	None`
`CreationTime`	`datetime	None`
`FileFormat`	`FileFormat`	Najbolji mogući pokazatelj verzije formata OneNote datoteke


`Count()`	`() -> int`	Broj direktnih podređenih stranica
`GetPageHistory(page)`	`(Page) -> list[Page]`	`[page]` (šablon; kompletna istorija još nije implementirana)
`DetectLayoutChanges()`	`() -> None`	Šablon kompatibilnosti; nema operacije
`Save(target, format_or_options)`	`(str	Path
`Accept(visitor)`	`(DocumentVisitor) -> None`	Pozovite obilazak posetioca
`for page in doc`	N/A	Iterirajte direktno dete `Page` čvorovi

Document.FileFormat napomena: Svojstvo pruža indikaciju, u najboljem mogućem slučaju, verzije formata OneNote fajla. The FileFormat enumeracija ima tri vrednosti: OneNote2010, OneNoteOnline, i OneNote2007.

Document.Save() podrška za stream: target može biti binarni stream (io.BytesIO, fajl hendel otvoren u binarnom režimu pisanja, itd.). Ovo je potvrđeno testnim paketom: doc.Save(io.BytesIO(), PdfSaveOptions(SaveFormat.Pdf)).

DocumentVisitor

Apstraktna bazna klasa za obilazak po obrascu posetioca. Prepišite metode posete koje su vam potrebne:

	Pozvano kada
`VisitDocumentStart(doc)`	Ulazak u čvor Dokumenta
`VisitDocumentEnd(doc)`	Napustanje čvora Dokumenta
`VisitPageStart(page)`	Ulazak u čvor Stranice
`VisitPageEnd(page)`	Napustanje čvora Stranice
`VisitTitleStart(title)`	Ulazak u Title čvor
`VisitTitleEnd(title)`	Napustanje Title čvora
`VisitOutlineStart(outline)`	Ulazak u Outline čvor
`VisitOutlineEnd(outline)`	Napustanje Outline čvora
`VisitOutlineElementStart(oe)`	Ulazak u OutlineElement čvor
`VisitOutlineElementEnd(oe)`	Napustanje OutlineElement čvora
`VisitRichTextStart(rt)`	Ulazak u RichText čvor
`VisitRichTextEnd(rt)`	Napustanje RichText čvora
`VisitImageStart(img)`	Ulazak u čvor Image
`VisitImageEnd(img)`	Napustanje čvora Image

Osnovna klasa za sve čvorove stabla dokumenta.

Svojstvo / Metod
`ParentNode`	`Node	None`
`Document`	`Document	None`
`Accept(visitor)`	`(DocumentVisitor) -> None`	Pokreni posetioca za ovaj čvor

CompositeNode

Node. Dodaje upravljanje podređenim elementima:

Svojstvo / Metod
`FirstChild`	Prvi podređeni čvor, ili `None`
`LastChild`	Poslednji podređeni čvor, ili `None`
`AppendChildLast(node)`	Dodaj podređeni čvor na kraju; postavlja `node.ParentNode = self`
`AppendChildFirst(node)`	Dodaj podređeni čvor na početku
`InsertChild(index, node)`	Umetni podređenog na zadatu poziciju
`RemoveChild(node)`	Ukloni podređeni čvor; postavlja `node.ParentNode = None`
`GetEnumerator()`	Vraća iterator nad direktnim potomcima
`for child in node`	Iteriraj direktne potomke
`GetChildNodes(Type)`	`(Type) -> list[Type]`: rekurzivno, pretraga po dubini celog podstabla uključujući `self`

CompositeNode. Predstavlja OneNote stranicu.


`Title`	`Title	None`
`Author`	`str	None`
`CreationTime`	`datetime	None`
`LastModifiedTime`	`datetime	None`
`Level`	`int	None`


`Clone(deep=False)`	Vrati plitku ili duboku klonu stranice

CompositeNode. Drži blok naslova Page.


`TitleText`	`RichText	None`
`TitleDate`	`RichText	None`
`TitleTime`	`RichText	None`

CompositeNode. Pozicioni kontejner za OutlineElement čvorove.


`X`	`float	None`
`Y`	`float	None`
`Width`	`float	None`

OutlineElement

CompositeNode. Kontejner list koji drži čvorove sadržaja.


`IndentLevel`	`int`	Dubina ugnježđivanja (0 = najspoljni)
`NumberList`	`NumberList	None`
`Tags`	`list[NoteTag]`	OneNote oznake pridružene ovom elementu

RichText

CompositeNode. Blok stilizovanog teksta.


`Text`	`str`	Puni običan tekst (svi segmenti spojeni)
`Runs`	`list[TextRun]`	Uređena lista formatiranih segmenata
`FontSize`	`float	None`
`Tags`	`list[NoteTag]`	OneNote oznake prikačene uz ovaj blok


`Append(text, style=None)`	`(str, TextStyle	None) -> RichText`
`Replace(old_value, new_value)`	`(str, str) -> None`	Zamena stringa u memoriji na `Text`; ne ažurira `Runs`

TextRun

Node. Jedan formatirani tekstualni segment.


`Text`	`str`	Tekstualni sadržaj segmenta (podrazumevano `""`)
`Style`	`TextStyle`	Svojstva formatiranja
`Start`	`int	None`
`End`	`int	None`

TextStyle

Node. Svojstva formatiranja po karakteru za TextRun.


`Bold`	`bool`	`False`
`Italic`	`bool`	`False`
`Underline`	`bool`	`False`
`Strikethrough`	`bool`	`False`
`Superscript`	`bool`	`False`
`Subscript`	`bool`	`False`
`FontName`	`str	None`	`None`
`FontSize`	`float	None`	`None`
`FontColor`	`int	None`	`None`
`HighlightColor`	`int	None`	`None`
`LanguageId`	`int	None`	`None`
`IsHyperlink`	`bool`	`False`	Da li je ovaj segment hiperveza
`HyperlinkAddress`	`str	None`	`None`

CompositeNode. Ugrađena slika.


`FileName`	`str	None`
`Bytes`	`bytes`	Sirovi podaci slike (podrazumevano `b""`)
`Width`	`float	None`
`Height`	`float	None`
`AlternativeTextTitle`	`str	None`
`AlternativeTextDescription`	`str	None`
`HyperlinkUrl`	`str	None`
`Tags`	`list[NoteTag]`	OneNote ознаке придодате овој слици


`Replace(image)`	`Bytes` и `FileName` из другог `Image` чвора у овај

AttachedFile

CompositeNode. Уграђени прилог датотеке.


`FileName`	`str	None`
`Bytes`	`bytes`	Сирови подаци датотеке (подразумевано `b""`)
`Tags`	`list[NoteTag]`	OneNote ознаке придодате овом прилогу

CompositeNode. Tabela unutar OutlineElement-a.


`Columns`	`list[float]`	`[]`	Širina svake kolone u tačkama
`IsBordersVisible`	`bool`	`True`	Da li su ivice tabele vidljive
`Tags`	`list[NoteTag]`	`[]`	OneNote oznake prikačene uz ovu tabelu

TableRow

CompositeNode. Red unutar a Table. Iteriraj GetChildNodes(TableCell) za pristup ćelijama.

TableCell

CompositeNode. Ćelija unutar a TableRow. Sadrži RichText, Image, i drugi čvorovi sadržaja.

NoteTag

Node. OneNote oznaka prikačena na čvor sadržaja.


`shape`	`int	None`	`None`
`label`	`str	None`	`None`
`text_color`	`int	None`	`None`
`highlight_color`	`int	None`	`None`
`created`	`int	None`	`None`
`completed`	`int	None`	`None`

Napomena o vremenskom žigu: created i completed su sirovi celobrojni vremenski žigovi parsirani iz MS-ONE binarnog formata, a ne datetime objekti.

Metode fabrike:


`NoteTag.CreateYellowStar()`	Kreira a `NoteTag(shape=None, label="Yellow Star")`

NumberList

Node. Metapodaci numerisane ili nabrajane liste na OutlineElement.


`Format`	`str	None`	`None`
`Restart`	`int	None`	`None`
`IsNumbered`	`bool`	`False`	Tačno za uređene (numerisane) liste

LoadOptions


`DocumentPassword`	`str	None`	`None`
`LoadHistory`	`bool`	`False`	Polje kompatibilnosti API‑ja; funkcionalno se ne koristi u v26.3.1

SaveOptions

Osnovna klasa za sve opcije čuvanja. Obavezan pozicioni argument.


`SaveFormat`	`SaveFormat`	Ciljani format za čuvanje

PdfSaveOptions

SaveOptions. PDF‑specifična konfiguracija izvoza. Konstruisati sa PdfSaveOptions(SaveFormat.Pdf).


`PageIndex`	`int`	`0`	Polje postoji; ne prosleđuje se PDF izvozniku u v26.3.1: nema efekta na izlaz
`PageCount`	`int	None`	`None`
`TagIconDir`	`str	None`	`None`
`TagIconSize`	`float	None`	`None`
`TagIconGap`	`float	None`	`None`

PageIndex / PageCount napomena: Ova polja su deklarisana na PdfSaveOptions za kompatibilnost API-ja, ali the Document.Save() implementacija u v26.3.1 ne čita niti prosleđuje ih PDF izvozniku. Sve stranice se uvek izvezu.

Licenca i tarifirano

Kompatibilnost stubova izvezenih radi API oblikovne kompatibilnosti sa Aspose.Note za .NET. Sve metode su bez efekta u ovoj FOSS implementaciji.

from aspose.note import License, Metered

lic = License()
lic.SetLicense("path/to/license.lic")  # no-op

m = Metered()
m.SetMeteredKey("public_key", "private_key")  # no-op

Nije potreban licencni ključ za korišćenje bilo koje funkcije Aspose.Note FOSS za Python.

Potpuna referenca enumeracije:

SaveFormat


`SaveFormat.Pdf`	PDF izvoz: implementirano; zahteva `pip install "aspose-note[pdf]"`
`SaveFormat.One`	OneNote format: deklarisan samo; podiže `UnsupportedSaveFormatException`

FileFormat

Enum vrednosti koje predstavljaju verziju OneNote formata fajla. Document.FileFormat pruža indikaciju na najbolji mogući način.

	String vrednost
`FileFormat.OneNote2010`	`"onenote2010"`
`FileFormat.OneNoteOnline`	`"onenoteonline"`
`FileFormat.OneNote2007`	`"onenote2007"`

HorizontalAlignment

	String vrednost
`HorizontalAlignment.Left`	`"left"`
`HorizontalAlignment.Center`	`"center"`
`HorizontalAlignment.Right`	`"right"`

NodeType

	Vrednost stringa
`NodeType.Document`	`"document"`
`NodeType.Page`	`"page"`
`NodeType.Outline`	`"outline"`
`NodeType.OutlineElement`	`"outline_element"`
`NodeType.RichText`	`"rich_text"`
`NodeType.Image`	`"image"`
`NodeType.Table`	`"table"`
`NodeType.AttachedFile`	`"attached_file"`

Puna referenca izuzetka:


`AsposeNoteError`	Osnovna klasa za sve Aspose.Note FOSS izuzetke
`FileCorruptedException`	`.one` datoteka se ne može parsirati (oštećena ili nepravilna binarna)
`IncorrectDocumentStructureException`	Struktura datoteke je nevažeća ili nepodržana
`IncorrectPasswordException`	Podignuto kada `LoadOptions.DocumentPassword` je postavljeno; šifrovani dokumenti nisu podržani
`UnsupportedFileFormatException`	Format datoteke nije prepoznat; izlaže a `FileFormat` polje (string)
`UnsupportedSaveFormatException`	Zahtevano `SaveFormat` nije implementirano u ovoj verziji