Aspose.Note FOSS pro Python
Tento odkaz pokrývá celou veřejnou plochu API pro: aspose-note Verze 26.3.1 Pouze symboly vyvážené z EU a ze zemí, které jsou součástí Evropské unie. aspose.note Vše, co je pod tímto kódem, se zde dokumentuje. aspose.note._internal je prováděcí podrobnost a může se bez předchozího oznámení změnit.
Import: from aspose.note import Document, RichText, ...
Dovoz: from aspose.note import Document, RichText, ...
Třídy
Install: pip install aspose-note (core) or pip install "aspose-note[pdf]" (with PDF export)
Dokumenty a průběh
| Třída | Popis: |
|---|---|
Document | Root document object. Reprezentuje OneNote dokument; iteruje stránky a exportuje do PDF. |
DocumentVisitor | Abstraktní základ pro průcházku vzorce návštěvníka v stromu dokumentu. |
Node | Základní třída pro všechny uzly dokumentu. |
CompositeNode | Základní třída pro uzly, které mohou obsahovat dětské uzliny. |
Struktura dokumentu
| Třída | Popis: |
|---|---|
Page | Zobrazuje stránku OneNote. |
Title | Blok názvu stránky obsahující TitleText, TitleDate a TitleTime. |
Outline | Poziční kontejner pro uzly OutlineElement. |
OutlineElement | Obsahující RichText, obrázek, tabulka, AttachedFile. |
Obsah:
| Třída | Popis: |
|---|---|
RichText | Textový blok s formátováním, tagy a hypertextovými odkazy. |
TextRun | Jednotný formátovaný textový segment v rámci RichText. |
TextStyle | Formátování vlastností pro TextRun. |
Image | Vestavěný obrázek s surovými bajty a metadaty. |
AttachedFile | Vestavěná souborová příloha s surovými bajty. |
Table | Tabulka s šířkou řádků, buněk a sloupců. |
TableRow | Řada v rámci stolu. |
TableCell | Buňka uvnitř TableRow; obsahuje obsahové uzly. |
NoteTag | OneNote tag (hvězda, zaškrtnutí políčka atd.) připojený k obsahu uzlu. |
NumberList | Numerované metadata seznamu na OutlineElement. |
Možnosti
| Třída | Popis: |
|---|---|
LoadOptions | Možnosti nakládky a .one - Soubor. |
SaveOptions | Základní třída pro možnosti uložení. |
PdfSaveOptions (viz bod 1.4.1): možnosti a parametry) | Klasa možností pro export dokumentu: ovládá komprese obrázků, kvalitu JPEG a nastavení stránek pro výstup PDF. |
Kompatibilní stuby
| Třída | Popis: |
|---|---|
License | Základní část kompatibility: SetLicense() je no-op v této implementaci FOSS. |
Metered | Základní část kompatibility: SetMeteredKey() je no-op v této implementaci FOSS. |
Podrobnosti o třídě
Dokumenty
Klasifikace základního dokumentu. .one soubor z cesty souboru, a pathlib.Path,nebo binární proud.
from aspose.note import Document, LoadOptions
doc = Document(source=None, load_options=None)Parametry konstruktoru:
| Parametr: | Typ: | Popis: |
|---|---|---|
source | `str | Path |
load_options | `LoadOptions | None` |
Vlastnosti:
| Vlastnictví | Typ: | Popis: |
|---|---|---|
FileFormat | FileFormat | Zásada nejlepšího úsilí pro verzi formátu souboru OneNote |
Metody:
| Metodika | Podpis: | Popis: |
|---|---|---|
GetPageHistory(page) | (Page) -> PageHistory | Zpětné výnosy [page] (stub; úplná historie ještě nebyla provedena) |
DetectLayoutChanges() | () -> None | Základní stub kompatibility; žádná operace |
Save(target, format_or_options) | `(str | Path |
Accept(visitor) | (DocumentVisitor) -> None | Vyvolání návštěvníka |
for page in doc | N/A | Iterovaný přímý syn Page uzly |
Document.FileFormatpoznámka::Vlastnost poskytuje nejlepší indikátor verze formátu souboru OneNote .FileFormatenum má tři hodnoty:OneNote2010,OneNoteOnline,a)OneNote2007.
Document.Save()Podpora proudění:targetmůže být binární tok (io.BytesIO, souborová ruka otevřená v binárním režimu psaní atd.).
DocumentVisitor
Abstraktní základní třída pro průcházku vzorů návštěvníků. Přehlížet potřebné metody návštevy:
| Metodika | Zavolal jsem, když… |
|---|---|
VisitDocumentStart(doc) | Vstup do uzlu dokumentu |
VisitDocumentEnd(doc) | Zanechání uzlu dokumentu |
VisitPageStart(page) | Vstup do uzlu stránky |
VisitPageEnd(page) | Zanechání uzlu stránky |
VisitTitleStart(title) | Vkládání uzlu názvu |
VisitTitleEnd(title) | Zanechání uzlu Titulu |
VisitOutlineStart(outline) | Vstup do uzlu Outline |
VisitOutlineEnd(outline) | Zanechání uzlu v přehledu |
VisitOutlineElementStart(oe) | Vstup na uzel OutlineElement |
VisitOutlineElementEnd(oe) | Zanechání uzlu OutlineElement |
VisitRichTextStart(rt) | Vstup na uzel RichText |
VisitRichTextEnd(rt) | Zanechání uzlu RichText |
VisitImageStart(img) | Vstup do uzlu snímku |
VisitImageEnd(img) | Zanechání uzlu snímku |
Vstupní uzel
Základní třída pro všechny uzly stromů dokumentů.
| Vlastnost / metoda | Typ: | Popis: |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
Accept(visitor) | (DocumentVisitor) -> None | Odeslat návštěvníka pro tento uzel . |
CompositeNode
Rozsah: Node.Přidává se:
| Vlastnost / metoda | Popis: |
|---|---|
FirstChild | První dětský uzel nebo None |
LastChild | Poslední dětský uzel nebo None |
AppendChildLast(node) | Přidat dětský uzel na konci; soubory node.ParentNode = self |
AppendChildFirst(node) | Přidat dítětský uzel na začátku . |
InsertChild(index, node) | Vložte dítě do dané polohy. |
RemoveChild(node) | Odstranit dětský uzel; soubory node.ParentNode = None |
GetEnumerator() | Vrátí iterátor přes přímé děti. |
for child in node | Iterované přímé děti |
GetChildNodes(Type) | (Type) -> list[Type]: rekurzivní, hluboký vyhledávání celého podstromu včetně: self |
Stránka
Rozsah: CompositeNode. Zobrazuje stránku OneNote.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
Title | `Title | None` |
Author | `str | None` |
CreationTime | `datetime | None` |
LastModifiedTime | `datetime | None` |
Level | `int | None` |
Metody:
| Metodika | Popis: |
|---|---|
Clone(deep=False) | Vrátit povrchní nebo hluboký klon stránky . |
Název:
Rozsah: CompositeNode.- Je držitelem titulu . Page.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
TitleText | `RichText | None` |
TitleDate | `RichText | None` |
TitleTime | `RichText | None` |
Přehled
Rozsah: CompositeNode.Postulatelný kontejner pro: OutlineElement uzly.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
HorizontalOffset | `float | None` |
VerticalOffset | `float | None` |
MaxWidth | `float | None` |
MaxHeight | `float | None` |
MinWidth | `float | None` |
ReservedWidth | `float | None` |
IndentPosition | `float | None` |
OutlineElement
Rozsah: CompositeNode.Obsahující obsahové uzly.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
NumberList | `NumberList | None` |
RichText
Rozsah: Node.- Blok stylizovaného textu.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
Text | str | Plný textový řetěz (všechny běhy souřadnice) |
TextRuns | list[TextRun] | Pořadový seznam formátovaných segmentů |
Tags | list[NoteTag] | OneNote značky připojené k tomuto bloku |
Metody:
| Metodika | Podpis: | Popis: |
|---|---|---|
Append(text, style=None) | `(str, TextStyle | None) -> RichText` |
Replace(old_value, new_value) | (str, str) -> None | V paměti nahradit řetězce na Text; není aktualizován TextRuns |
TextRun
Jediný formátovaný textový segment v rámci: RichText.TextRuns.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
Text | str | Obsah textu segmentu (podstatné) "") |
Style | TextStyle | Vlastnosti formátování |
TextStyle
Vlastnosti formátování na znak pro: TextRun.
| Vlastnictví | Typ: | Předvoleně | Popis: |
|---|---|---|---|
IsBold | bool | False | Odvážný . |
IsItalic | bool | False | Kurzovní písmeno |
IsUnderline | bool | False | Podtrhnout |
IsStrikethrough | bool | False | Průběh |
IsSuperscript | bool | False | Přehled |
IsSubscript | bool | False | Podpis |
FontName | `str | None` | None |
FontSize | `float | None` | None |
FontColor | `int | None` | None |
Highlight | `int | None` | None |
Language | `int | None` | None |
IsHyperlink | bool | False | Zda je tento běh hypertextový odkaz. |
HyperlinkAddress | `str | None` | None |
Obraz:
Rozsah: CompositeNode.Vložený obraz.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
FileName | `str | None` |
FilePath | `str | None` |
Format | `str | None` |
Bytes | bytes | První data bytu obrazu (podstatné) b"") |
OriginalWidth | `float | None` |
OriginalHeight | `float | None` |
Alignment | `HorizontalAlignment | None` |
Tags | list[NoteTag] | OneNote značky připojené k tomuto obrázku |
Metody:
| Metodika | Popis: |
|---|---|
Replace(image) | Přepsané. Bytes a) FileName z jiného Image Vstupte do tohoto. |
AttachedFile
Rozsah: Node.- Vkládaný soubor.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | První data souboru (podstatné) b"") |
Tags | list[NoteTag] | OneNote značky připojené k tomuto přílohovému dokumentu |
Tabulka 1
Rozsah: CompositeNode.Tabela uvnitř OutlineElement.
| Vlastnictví | Typ: | Předvoleně | Popis: |
|---|---|---|---|
Columns | list[TableColumn] | [] | Seznam sloupců metadát; každý TableColumn má: .Width (plavka) a .LockedWidth - Ne, ne. - Cože? |
Tags | list[NoteTag] | [] | OneNote značky připojené k této tabulce |
TableRow
Rozsah: CompositeNode.Řádek v rámci řady . Table.- Iterativní. GetChildNodes(TableCell) k přístupu do buňky.
TableCell
Rozsah: CompositeNode. Buňka v rámci … TableRow.Obsahuje: RichText, Image, a další obsahové uzly.
NoteTag
Tyg OneNote připojený k obsahu.
| Vlastnictví | Typ: | Předvoleně | Popis: |
|---|---|---|---|
Icon | `int | None` | None |
Label | `str | None` | None |
FontColor | `int | None` | None |
Highlight | `int | None` | None |
CreationTime | `datetime | None` | None |
CompletedTime | `datetime | None` | None |
Status | TagStatus | odvozené | TagStatus.Completed pokud: CompletedTime je nastaven, jinak TagStatus.Open |
Zpracovatelské metody:
| Metodika | Popis: |
|---|---|
NoteTag.CreateYellowStar(label=None) | Vytváří se NoteTag(Label="Yellow Star", Icon=13) |
NoteTag.CreateQuestionMark(label=None) | Vytváří se NoteTag(Label="Question Mark", Icon=15) |
NoteTag.CreateMusicalNote(label=None) | Vytváří se NoteTag(Label="Musical Note", Icon=121) |
NumberList
Metadata čísleného nebo sčítaného seznamu na OutlineElement.
| Vlastnictví | Typ: | Předvoleně | Popis: |
|---|---|---|---|
Format | `str | None` | None |
NumberFormat | `str | None` | None |
Font | `str | None` | None |
FontSize | `float | None` | None |
FontColor | `int | None` | None |
IsBold | bool | False | Tvrdá váha pro předponu seznamu |
IsItalic | bool | False | Kurzivní styl pro předčíslo seznamu |
Restart | `int | None` | None |
LoadOptions
| Vlastnictví | Typ: | Předvoleně | Popis: |
|---|---|---|---|
DocumentPassword | `str | None` | None |
LoadHistory | bool | False | Pole kompatibility API; není funkčně použito v verzi 26.3.1 |
SaveOptions
Základní třída pro možnosti uložení. Požadovaný poziční argument.
| Vlastnictví | Typ: | Popis: |
|---|---|---|
SaveFormat | SaveFormat | Formát ukládání cíle |
PdfSaveOptions
Rozsah: SaveOptions. PDF-specifikní konfigurace vývozu. Konstruovat s PdfSaveOptions() (všechny argumenty jsou pouze klíčová slova s výchozími funkcemi).
| Vlastnictví | Typ: | Předvoleně | Popis: |
|---|---|---|---|
PageIndex | int | 0 | Pole existuje; není předán vývozci PDF v verzi 26.3.1: nemá vliv na výstup |
PageCount | `int | None` | None |
ImageCompression | `Any | None` | None |
JpegQuality | `int | None` | None |
PageSettings | `Any | None` | None |
PageSplittingAlgorithm | `Any | None` | None |
PageIndex/PageCountvýstraha:Tato pole jsou vyjádřena na:PdfSaveOptionspro kompatibilitu s API, aleDocument.Save()Implementace v verzi 26.3.1 se nepoužije a není předávána vývozci PDF. Všechny stránky jsou vždy exportovány.
Licence a měření
Kompatibilita stubů exportované pro API tvar kompatibility s Aspose.Note pro .NET. Všechny metody jsou no-ops v této implementaci FOSS.
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Žádný licenční klíč není potřebný k použití jakékoli funkce Aspose.Note FOSS pro Python.
Číslování
Úplný odkaz na vyčíslení: Číslování
SaveFormat
| Hodnota | Popis: |
|---|---|
SaveFormat.Pdf | Export PDF: realizován; vyžaduje se pip install "aspose-note[pdf]" |
FileFormat
Věci, které představují verzi formátu souboru OneNote. Document.FileFormat poskytuje indikátor nejlepšího úsilí.
| Hodnota | Hodnota řetězce |
|---|---|
FileFormat.OneNote2010 | "onenote2010" |
FileFormat.OneNoteOnline | "onenoteonline" |
FileFormat.OneNote2007 | "onenote2007" |
HorizontalAlignment
| Hodnota | Hodnota řetězce |
|---|---|
HorizontalAlignment.Left | "left" |
HorizontalAlignment.Center | "center" |
HorizontalAlignment.Right | "right" |
NodeType
| Hodnota | Hodnota řetězce |
|---|---|
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" |
Výjimky
Úplná výjimka: Výjimky
| Výjimka | Popis: |
|---|---|
AsposeNoteError | Základní třída pro všechny výjimky FOSS Aspose.Note |
FileCorruptedException | Úřad pro bezpečnost a ochranu zdraví .one soubor nelze analyzovat (poškozený nebo špatně formovaný binární kód) |
IncorrectDocumentStructureException | Struktura souboru je neplatná nebo nepodporovaná. |
IncorrectPasswordException | Vyrostl, když LoadOptions.DocumentPassword je nastaveno; šifrované dokumenty nejsou podporovány. |
UnsupportedFileFormatException | Formát souboru není rozpoznán; odhalí FileFormat pole (struna) |
UnsupportedSaveFormatException | Žádost o SaveFormat není implementován v této verzi. |