Aspose.Note FOSS for Python
Ez a referencia lefedi a teljes nyilvános API felületet a aspose-note 26.3.1 verzió. Csak a csomagból exportált szimbólumok aspose.note csomagban dokumentálva vannak itt. Minden, ami alatta aspose.note._internal egy implementációs részlet, és előzetes értesítés nélkül változhat.
ImageRenderOptions: pip install aspose-note (core) vagy pip install "aspose-note[pdf]" (PDF exporttal)
ImageRenderOptions: from aspose.note import Document, RichText, ...
ImageRenderOptions
Dokumentum és bejárás
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Document | Gyökér dokumentumobjektum. Tölts be egy .one fájlt, iterálj az oldalakon, és ments PDF-be. |
DocumentVisitor | Absztrakt alap a látogató-minta szerinti bejáráshoz a dokumentumfában. |
Node | Alaposztály minden dokumentumcsomóponthoz. |
CompositeNode | Alaposztály azokhoz a csomópontokhoz, amelyek gyermekcsomópontokat tartalmazhatnak. |
Dokumentum struktúra
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Page | Egy OneNote oldalt reprezentál. |
Title | Oldalcím blokk, amely a TitleText, TitleDate és TitleTime elemeket tartalmazza. |
Outline | Pozíciós tároló az OutlineElement csomópontok számára. |
OutlineElement | Levél tároló; RichText, Image, Table és AttachedFile elemeket tartalmaz. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
RichText | Szöveges blokk formázási futamokkal, címkékkel és hiperhivatkozásokkal. |
TextRun | Egyetlen formázott szövegszakasz a RichText-ben. |
TextStyle | Formázási tulajdonságok a TextRun számára. |
Image | Beágyazott kép nyers bájtokkal és metaadatokkal. |
AttachedFile | Beágyazott fájlcsatolás nyers bájtokkal. |
Table | Táblázat sorokkal, cellákkal és oszlopszélességekkel. |
TableRow | Egy sor a táblázaton belül. |
TableCell | Egy cella egy TableRow-ban; tartalmaz tartalomcsomópontokat. |
NoteTag | OneNote címke (csillag, jelölőnégyzet stb.) egy tartalomcsomóponthoz csatolva. |
NumberList | Számozott lista metaadatai egy OutlineElement-en. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
LoadOptions | Betöltési beállítások egy .one fájl. |
SaveOptions | Alaposztály a mentési beállításokhoz. |
PdfSaveOptions | PDF-specifikus mentési beállítások (címkeikonok). |
Kompatibilitási stubok
| ImageRenderOptions | ImageRenderOptions |
|---|---|
License | Kompatibilitási helyettesítő: SetLicense() nem csinál semmit ebben a FOSS megvalósításban. |
Metered | Kompatibilitási stub: SetMeteredKey() nem csinál semmit ebben a FOSS megvalósításban. |
Osztály részletei
ImageRenderOptions
A gyökér dokumentumosztály. Töltsön be egy .one fájlt egy fájl útvonalról, egy pathlib.Path, vagy egy bináris adatfolyam.
from aspose.note import Document, LoadOptions
doc = Document(source=None, load_options=None)Konstruktor paraméterek:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
source | `str | Path |
load_options | `LoadOptions | None` |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
DisplayName | `str | None` |
CreationTime | `datetime | None` |
FileFormat | FileFormat | Legjobb erőfeszítéssel nyújtott jelzés a OneNote fájlformátum verziójáról |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Count() | () -> int | Közvetlen gyermekoldalak száma |
GetPageHistory(page) | (Page) -> list[Page] | ImageRenderOptions [page] (helyőrző; a teljes előzmény még nincs megvalósítva) |
DetectLayoutChanges() | () -> None | Kompatibilitási helyőrző; nincs művelet |
Save(target, format_or_options) | `(str | Path |
Accept(visitor) | (DocumentVisitor) -> None | Látogató bejárás meghívása |
for page in doc | N/A | Közvetlen gyermek iterálása Page csomópontok |
Document.FileFormat megjegyzés: A tulajdonság legjobb erőfeszítéssel nyújtott jelzést ad a OneNote fájlformátum verziójáról. A FileFormat az enum három értékkel rendelkezik: OneNote2010, OneNoteOnline, és OneNote2007.
Document.Save() stream támogatás: target lehet bináris folyam (io.BytesIO, bináris írási módban megnyitott fájlkezelő, stb.). Ezt a tesztsorozat erősíti meg: doc.Save(io.BytesIO(), PdfSaveOptions(SaveFormat.Pdf)).
DocumentVisitor
Absztrakt bázisosztály a látogató-minta bejáráshoz. Felülírhatja a szükséges visit metódusokat:
| ImageRenderOptions | Hívva, amikor |
|---|---|
VisitDocumentStart(doc) | Belépés egy Document csomópontba |
VisitDocumentEnd(doc) | Kilépés egy Document csomópontból |
VisitPageStart(page) | Belépés egy Page csomópontba |
VisitPageEnd(page) | Kilépés egy Page csomópontból |
VisitTitleStart(title) | Belépés egy Title csomópontba |
VisitTitleEnd(title) | Kilépés egy Title csomópontból |
VisitOutlineStart(outline) | Belépés egy Outline csomópontba |
VisitOutlineEnd(outline) | Kilépés egy Outline csomópontból |
VisitOutlineElementStart(oe) | Belépés egy OutlineElement csomópontba |
VisitOutlineElementEnd(oe) | Kilépés egy OutlineElement csomópontból |
VisitRichTextStart(rt) | Belépés egy RichText csomópontba |
VisitRichTextEnd(rt) | Kilépés egy RichText csomópontból |
VisitImageStart(img) | Belépés egy Image csomópontba |
VisitImageEnd(img) | Kilépés egy Image csomópontból |
ImageRenderOptions
Alaposztály minden dokumentumfa csomópont számára.
| Tulajdonság / Metódus | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
Accept(visitor) | (DocumentVisitor) -> None | Lefuttatja a látogatót ehhez a csomóponthoz |
CompositeNode
ImageRenderOptions Node. Gyermekkezelést ad hozzá:
| Tulajdonság / Metódus | ImageRenderOptions |
|---|---|
FirstChild | Első gyermekcsomópont, vagy None |
LastChild | Utolsó gyermekcsomópont, vagy None |
AppendChildLast(node) | Gyermekcsomópont hozzáadása a végén; beállítja node.ParentNode = self |
AppendChildFirst(node) | Gyermekcsomópont hozzáadása az elején |
InsertChild(index, node) | Gyermek beszúrása a megadott pozícióba |
RemoveChild(node) | Gyermekcsomópont eltávolítása; beállítja node.ParentNode = None |
GetEnumerator() | Visszaad egy iterátort a közvetlen gyermekek felett |
for child in node | Közvetlen gyermekek iterálása |
GetChildNodes(Type) | (Type) -> list[Type]: rekurzív, mélységi bejárás az egész alfa struktúrában, beleértve self |
ImageRenderOptions
ImageRenderOptions CompositeNode. Egy OneNote oldalt ábrázol.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Title | `Title | None` |
Author | `str | None` |
CreationTime | `datetime | None` |
LastModifiedTime | `datetime | None` |
Level | `int | None` |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Clone(deep=False) | Visszaadja az oldal sekély vagy mély klónját |
ImageRenderOptions
ImageRenderOptions CompositeNode. Tartja egy címblokkot Page.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
TitleText | `RichText | None` |
TitleDate | `RichText | None` |
TitleTime | `RichText | None` |
ImageRenderOptions
ImageRenderOptions CompositeNode. Egy pozíciós tároló a OutlineElement csomópontok.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
X | `float | None` |
Y | `float | None` |
Width | `float | None` |
OutlineElement
ImageRenderOptions CompositeNode. Egy levél tároló, amely tartalomcsomópontokat tartalmaz.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
IndentLevel | int | Beágyazási mélység (0 = legkülső) |
NumberList | `NumberList | None` |
Tags | list[NoteTag] | OneNote címkék, amelyek ehhez az elemhez vannak csatolva |
RichText
ImageRenderOptions CompositeNode. Egy stílusos szövegrész.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Text | str | Teljes egyszerű szöveg karakterlánc (az összes futam összefűzve) |
Runs | list[TextRun] | Rendezett lista a formázott szegmensekből |
FontSize | `float | None` |
Tags | list[NoteTag] | OneNote címkék, amelyek ehhez a blokkhoz vannak csatolva |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Append(text, style=None) | `(str, TextStyle | None) -> RichText` |
Replace(old_value, new_value) | (str, str) -> None | Memóriában végzett karakterlánc helyettesítés Text; nem frissül Runs |
TextRun
ImageRenderOptions Node. Egyetlen formázott szövegszegmens.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Text | str | A szegmens szövegtartalma (alapértelmezett "") |
Style | TextStyle | Formázási tulajdonságok |
Start | `int | None` |
End | `int | None` |
TextStyle
ImageRenderOptions Node. Karakterenkénti formázási tulajdonságok egy 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 | Ez a futás hiperhivatkozás-e |
HyperlinkAddress | `str | None` | None |
ImageRenderOptions
ImageRenderOptions CompositeNode. Beágyazott kép.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | Nyers képadatok (alapértelmezett b"") |
Width | `float | None` |
Height | `float | None` |
AlternativeTextTitle | `str | None` |
AlternativeTextDescription | `str | None` |
HyperlinkUrl | `str | None` |
Tags | list[NoteTag] | OneNote címkék, amelyek ehhez a képhez vannak csatolva |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Replace(image) | ImageRenderOptions Bytes és FileName másikból Image ebbe a csomópontba |
AttachedFile
ImageRenderOptions CompositeNode. Beágyazott fájlcsatolás.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | Nyers fájladatok (alapértelmezett b"") |
Tags | list[NoteTag] | OneNote címkék, amelyek ehhez a csatolmányhoz vannak csatolva |
ImageRenderOptions
ImageRenderOptions CompositeNode. Egy táblázat egy OutlineElementben.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Columns | list[float] | [] | Minden oszlop szélessége pontban |
IsBordersVisible | bool | True | A táblázat szegélyeinek láthatósága |
Tags | list[NoteTag] | [] | OneNote címkék, amelyek ehhez a táblázathoz vannak csatolva |
TableRow
ImageRenderOptions CompositeNode. Egy sor egy Table. Iterálj GetChildNodes(TableCell) a cellák eléréséhez.
TableCell
ImageRenderOptions CompositeNode. Egy cella egy TableRow. Tartalmaz RichText, Image, és egyéb tartalomcsomópontok.
NoteTag
ImageRenderOptions Node. Egy OneNote címke, amely egy tartalomcsomóponthoz van csatolva.
| 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 |
Időbélyeg megjegyzés: created és completed nyers egész számú időbélyegek, ahogy a MS-ONE bináris formátumból ki lettek értelmezve, nem datetime objektumok.
Gyári metódusok:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
NoteTag.CreateYellowStar() | Létrehoz egy NoteTag(shape=None, label="Yellow Star") |
NumberList
ImageRenderOptions Node. Számozott vagy felsorolásjeles lista metaadatai egy OutlineElement.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Format | `str | None` | None |
Restart | `int | None` | None |
IsNumbered | bool | False | Igaz a rendezett (számozott) listák esetén |
LoadOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
DocumentPassword | `str | None` | None |
LoadHistory | bool | False | API kompatibilitási mező; funkcionálisan nem használatos a v26.3.1‑ben |
SaveOptions
Alaposztály minden mentési beállításhoz. Kötelező pozíciós argumentum.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
SaveFormat | SaveFormat | Cél mentési formátum |
PdfSaveOptions
ImageRenderOptions SaveOptions. PDF-specifikus export konfiguráció. Létrehozva a PdfSaveOptions(SaveFormat.Pdf).
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
PageIndex | int | 0 | Mező létezik; nem továbbítva a PDF exportálóhoz a v26.3.1‑ben: nincs hatása a kimenetre |
PageCount | `int | None` | None |
TagIconDir | `str | None` | None |
TagIconSize | `float | None` | None |
TagIconGap | `float | None` | None |
PageIndex / PageCount figyelmeztetés: Ezek a mezők deklarálva vannak a PdfSaveOptions az API-kompatibilitás érdekében, de a Document.Save() a v26.3.1-es megvalósítás nem olvassa be, és nem továbbítja őket a PDF exportálóhoz. Az összes oldal mindig exportálva van.
Licenc és Mérő
Kompatibilitási stubok exportálva az API szerkezet kompatibilitásához a Aspose.Note és .NET között. Minden metódus semmit nem csinál ebben a FOSS megvalósításban.
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-opNem szükséges licenckulcs a Aspose.Note FOSS Python funkcióinak használatához.
ImageRenderOptions
Teljes felsorolás hivatkozás: ImageRenderOptions
SaveFormat
| ImageRenderOptions | ImageRenderOptions |
|---|---|
SaveFormat.Pdf | PDF exportálás: megvalósítva; igényli pip install "aspose-note[pdf]" |
SaveFormat.One | OneNote formátum: csak deklarált; kivételt dob UnsupportedSaveFormatException |
FileFormat
Felsorolásértékek, amelyek a OneNote fájlformátum verzióját képviselik. Document.FileFormat legjobb erőfeszítéssel nyújtott jelzés.
| ImageRenderOptions | Karakterlánc érték |
|---|---|
FileFormat.OneNote2010 | "onenote2010" |
FileFormat.OneNoteOnline | "onenoteonline" |
FileFormat.OneNote2007 | "onenote2007" |
HorizontalAlignment
| ImageRenderOptions | Karakterlánc érték |
|---|---|
HorizontalAlignment.Left | "left" |
HorizontalAlignment.Center | "center" |
HorizontalAlignment.Right | "right" |
NodeType
| ImageRenderOptions | Karakterlánc érték |
|---|---|
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
Teljes kivétel hivatkozás: ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
AsposeNoteError | Alaposztály minden Aspose.Note FOSS kivételhez |
FileCorruptedException | ImageRenderOptions .one a fájlt nem lehet feldolgozni (sérült vagy hibás bináris) |
IncorrectDocumentStructureException | A fájlstruktúra érvénytelen vagy nem támogatott |
IncorrectPasswordException | Kivétel dobódik, amikor LoadOptions.DocumentPassword be van állítva; a titkosított dokumentumok nem támogatottak |
UnsupportedFileFormatException | A fájlformátum nem felismert; egy FileFormat mező (string) |
UnsupportedSaveFormatException | A kért SaveFormat nincs megvalósítva ebben a verzióban |