Aspose.Note FOSS for Python
Denna referens täcker hela den offentliga API-ytan för aspose-note version 26.3.1. Endast symboler som exporteras från aspose.note paketet dokumenteras här. Allt under aspose.note._internal är en implementationsdetalj och kan ändras utan förvarning.
ImageRenderOptions: pip install aspose-note (core) eller pip install "aspose-note[pdf]" (med PDF-export)
ImageRenderOptions: from aspose.note import Document, RichText, ...
ImageRenderOptions
Dokument och traversering
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Document | Rotdokumentobjekt. Ladda en .one fil, iterera sidor och spara till PDF. |
DocumentVisitor | Abstrakt bas för besökarmönstertraversering av dokumentträdet. |
Node | Basklass för alla dokumentnoder. |
CompositeNode | Basklass för noder som kan innehålla undernoder. |
Dokumentstruktur
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Page | Representerar en OneNote-sida. |
Title | Sidans titelblock som innehåller TitleText, TitleDate, TitleTime. |
Outline | Positionsbehållare för OutlineElement-noder. |
OutlineElement | Lövbehållare; innehåller RichText, Image, Table, AttachedFile. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
RichText | Textblock med formateringssekvenser, taggar och hyperlänkar. |
TextRun | Enstaka formaterad textsegment inom en RichText. |
TextStyle | Formateringsegenskaper för en TextRun. |
Image | Inbäddad bild med råa byte och metadata. |
AttachedFile | Inbäddad filbilaga med råa byte. |
Table | Tabell med rader, celler och kolumnbredder. |
TableRow | En rad i en tabell. |
TableCell | En cell i en TableRow; innehåller innehållsnoder. |
NoteTag | OneNote‑tagg (stjärna, kryssruta osv.) som är bifogad till en innehållsnod. |
NumberList | Numrerad listmetadata på ett OutlineElement. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
LoadOptions | Alternativ för att ladda en .one fil. |
SaveOptions | Basklass för sparalternativ. |
PdfSaveOptions | PDF‑specifika sparalternativ (taggikoner). |
Kompatibilitetsstubb
| ImageRenderOptions | ImageRenderOptions |
|---|---|
License | Kompatibilitetsstub: SetLicense() är en ingen‑operation i denna FOSS‑implementation. |
Metered | Kompatibilitetsstub: SetMeteredKey() är en ingen‑operation i denna FOSS‑implementation. |
Klassdetaljer
ImageRenderOptions
Rotdokumentklassen. Ladda en .one fil från en filsökväg, en pathlib.Path, eller en binär ström.
from aspose.note import Document, LoadOptions
doc = Document(source=None, load_options=None)Konstruktörsparametrar:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
source | `str | Path |
load_options | `LoadOptions | None` |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
DisplayName | `str | None` |
CreationTime | `datetime | None` |
FileFormat | FileFormat | Bästa möjliga indikation på OneNote-filformatets version |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Count() | () -> int | Antal direkta underordnade sidor |
GetPageHistory(page) | (Page) -> list[Page] | ImageRenderOptions [page] (platshållare; fullständig historik ännu inte implementerad) |
DetectLayoutChanges() | () -> None | Kompatibilitetsplatshållare; ingen operation |
Save(target, format_or_options) | `(str | Path |
Accept(visitor) | (DocumentVisitor) -> None | Anropa besökare‑traversering |
for page in doc | N/A | Iterera direkta underordnade Page noder |
Document.FileFormat anteckning: Egenskapen ger en bästa möjliga indikation på OneNote-filformatets version. Den FileFormat enum har tre värden: OneNote2010, OneNoteOnline, och OneNote2007.
Document.Save() strömstöd: target kan vara en binärström (io.BytesIO, filhandtag öppnat i binärt skrivläge, etc.). Detta bekräftas av testsviten: doc.Save(io.BytesIO(), PdfSaveOptions(SaveFormat.Pdf)).
DocumentVisitor
Abstrakt basklass för traversering med besökarmönster. Åsidosätt de besöksmetoder du behöver:
| ImageRenderOptions | Kallas när |
|---|---|
VisitDocumentStart(doc) | Går in i en Document-nod |
VisitDocumentEnd(doc) | Lämnar en Document-nod |
VisitPageStart(page) | Går in i en Page-nod |
VisitPageEnd(page) | Lämnar en Page-nod |
VisitTitleStart(title) | Går in i en Title-nod |
VisitTitleEnd(title) | Lämnar en Title-nod |
VisitOutlineStart(outline) | Går in i en Outline-nod |
VisitOutlineEnd(outline) | Lämnar en Outline-nod |
VisitOutlineElementStart(oe) | Går in i en OutlineElement-nod |
VisitOutlineElementEnd(oe) | Lämnar en OutlineElement-nod |
VisitRichTextStart(rt) | Går in i en RichText-nod |
VisitRichTextEnd(rt) | Lämnar en RichText-nod |
VisitImageStart(img) | Går in i en Image-nod |
VisitImageEnd(img) | Lämnar en Image-nod |
ImageRenderOptions
Basklass för alla dokumentträdnoder.
| Egenskap / Metod | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
Accept(visitor) | (DocumentVisitor) -> None | Skicka besökare för den här noden |
CompositeNode
ImageRenderOptions Node. Lägger till barnhantering:
| Egenskap / Metod | ImageRenderOptions |
|---|---|
FirstChild | Första barnnod, eller None |
LastChild | Sista barnnod, eller None |
AppendChildLast(node) | Lägg till en barnnod i slutet; sätter node.ParentNode = self |
AppendChildFirst(node) | Lägg till en barnnod i början |
InsertChild(index, node) | Infoga ett barn på angiven position |
RemoveChild(node) | Ta bort en barnnod; sätter node.ParentNode = None |
GetEnumerator() | Returnerar en iterator över direkta barn |
for child in node | Iterera direkta barn |
GetChildNodes(Type) | (Type) -> list[Type]: rekursiv, djup-först-sökning av hela underträdet inklusive self |
ImageRenderOptions
ImageRenderOptions CompositeNode. Representerar en OneNote-sida.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Title | `Title | None` |
Author | `str | None` |
CreationTime | `datetime | None` |
LastModifiedTime | `datetime | None` |
Level | `int | None` |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Clone(deep=False) | Returnera en ytlig eller djup klon av sidan |
ImageRenderOptions
ImageRenderOptions CompositeNode. Innehåller titelblocket för en Page.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
TitleText | `RichText | None` |
TitleDate | `RichText | None` |
TitleTime | `RichText | None` |
ImageRenderOptions
ImageRenderOptions CompositeNode. En positionsbehållare för OutlineElement noder.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
X | `float | None` |
Y | `float | None` |
Width | `float | None` |
OutlineElement
ImageRenderOptions CompositeNode. En bladbehållare som innehåller innehållsnoder.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
IndentLevel | int | Nästningsdjup (0 = ytterst) |
NumberList | `NumberList | None` |
Tags | list[NoteTag] | OneNote-taggar kopplade till detta element |
RichText
ImageRenderOptions CompositeNode. Ett block med formaterad text.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Text | str | Fullständig klartextsträng (alla körningar sammanfogade) |
Runs | list[TextRun] | Ordnad lista med formaterade segment |
FontSize | `float | None` |
Tags | list[NoteTag] | OneNote-taggar kopplade till detta block |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Append(text, style=None) | `(str, TextStyle | None) -> RichText` |
Replace(old_value, new_value) | (str, str) -> None | Strängsubstitution i minnet på Text; uppdateras inte Runs |
TextRun
ImageRenderOptions Node. Ett enda formaterat textsegment.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Text | str | Segmentets textinnehåll (standard "") |
Style | TextStyle | Formateringsegenskaper |
Start | `int | None` |
End | `int | None` |
TextStyle
ImageRenderOptions Node. Per-tecken formateringsegenskaper för en TextRun.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Bold | bool | False | ImageRenderOptions |
Italic | bool | False | ImageRenderOptions |
Underline | bool | False | ImageRenderOptions |
Strikethrough | bool | False | ImageRenderOptions |
Superscript | bool | False | ImageRenderOptions |
Subscript | bool | False | ImageRenderOptions |
FontName | `str | None` | None |
FontSize | `float | None` | None |
FontColor | `int | None` | None |
HighlightColor | `int | None` | None |
LanguageId | `int | None` | None |
IsHyperlink | bool | False | Om detta segment är en hyperlänk |
HyperlinkAddress | `str | None` | None |
ImageRenderOptions
ImageRenderOptions CompositeNode. En inbäddad bild.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | Rå bilddata (standard b"") |
Width | `float | None` |
Height | `float | None` |
AlternativeTextTitle | `str | None` |
AlternativeTextDescription | `str | None` |
HyperlinkUrl | `str | None` |
Tags | list[NoteTag] | OneNote-taggar kopplade till den här bilden |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Replace(image) | ImageRenderOptions Bytes och FileName från en annan Image nod till den här |
AttachedFile
ImageRenderOptions CompositeNode. En inbäddad filbilaga.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | Rå fildata (standard b"") |
Tags | list[NoteTag] | OneNote-taggar kopplade till den här bilagan |
ImageRenderOptions
ImageRenderOptions CompositeNode. En tabell inom ett OutlineElement.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Columns | list[float] | [] | Bredd på varje kolumn i punkter |
IsBordersVisible | bool | True | Om tabellramar är synliga |
Tags | list[NoteTag] | [] | OneNote-taggar kopplade till den här tabellen |
TableRow
ImageRenderOptions CompositeNode. En rad inom en Table. Iterera GetChildNodes(TableCell) för att komma åt celler.
TableCell
ImageRenderOptions CompositeNode. En cell inom en TableRow. Innehåller RichText, Image, och andra innehållsnoder.
NoteTag
ImageRenderOptions Node. En OneNote‑tagg bifogad till en innehållsnod.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
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 |
Tidsstämpelanteckning: created och completed är råa heltalstidsstämplar som parsats från MS-ONE‑binärformatet, inte datetime objekt.
Fabrikmetoder:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
NoteTag.CreateYellowStar() | Skapar en NoteTag(shape=None, label="Yellow Star") |
NumberList
ImageRenderOptions Node. Numrerad eller punktlista metadata på en OutlineElement.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Format | `str | None` | None |
Restart | `int | None` | None |
IsNumbered | bool | False | Sant för ordnade (numrerade) listor |
LoadOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
DocumentPassword | `str | None` | None |
LoadHistory | bool | False | API-kompatibilitetsfält; används inte funktionellt i v26.3.1 |
SaveOptions
Basklass för alla sparalternativ. Obligatoriskt positionsargument.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
SaveFormat | SaveFormat | Målsparformat |
PdfSaveOptions
ImageRenderOptions SaveOptions. PDF-specifik exportkonfiguration. Bygg med PdfSaveOptions(SaveFormat.Pdf).
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
PageIndex | int | 0 | Fältet finns; skickas inte vidare till PDF-exportören i v26.3.1: har ingen effekt på utdata |
PageCount | `int | None` | None |
TagIconDir | `str | None` | None |
TagIconSize | `float | None` | None |
TagIconGap | `float | None` | None |
PageIndex / PageCount förbehåll: Dessa fält är deklarerade på PdfSaveOptions för API-kompatibilitet, men Document.Save() implementationen i v26.3.1 läser inte dem eller vidarebefordrar dem till PDF-exportören. Alla sidor exporteras alltid.
Licens och mätad
Kompatibilitetsstubbar exporteras för API‑formkompatibilitet med Aspose.Note för .NET. Alla metoder är ingen‑operationer i denna FOSS‑implementation.
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-opIngen licensnyckel krävs för att använda någon funktion i Aspose.Note FOSS för Python.
ImageRenderOptions
Fullständig uppräkningreferens: ImageRenderOptions
SaveFormat
| ImageRenderOptions | ImageRenderOptions |
|---|---|
SaveFormat.Pdf | PDF-export: implementerad; kräver pip install "aspose-note[pdf]" |
SaveFormat.One | OneNote-format: endast deklarerat; kastar UnsupportedSaveFormatException |
FileFormat
Enum‑värden som representerar OneNote‑filformatets version. Document.FileFormat ger en bästa‑möjliga indikation.
| ImageRenderOptions | Strängvärde |
|---|---|
FileFormat.OneNote2010 | "onenote2010" |
FileFormat.OneNoteOnline | "onenoteonline" |
FileFormat.OneNote2007 | "onenote2007" |
HorizontalAlignment
| ImageRenderOptions | Strängvärde |
|---|---|
HorizontalAlignment.Left | "left" |
HorizontalAlignment.Center | "center" |
HorizontalAlignment.Right | "right" |
NodeType
| ImageRenderOptions | Strängvärde |
|---|---|
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" |
ImageRenderOptions
Fullständig undantagsreferens: ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
AsposeNoteError | Basklass för alla Aspose.Note FOSS‑undantag |
FileCorruptedException | ImageRenderOptions .one filen kan inte parsas (korrupt eller felaktig binär) |
IncorrectDocumentStructureException | Filstrukturen är ogiltig eller stöds inte |
IncorrectPasswordException | Kastas när LoadOptions.DocumentPassword är satt; krypterade dokument stöds inte |
UnsupportedFileFormatException | Filformatet känns inte igen; exponerar en FileFormat fält (string) |
UnsupportedSaveFormatException | Den begärda SaveFormat är inte implementerad i den här versionen |