Aspose.Note FOSS for Python

Questa referenza copre l’intera superficie dell’API pubblica di aspose-note versione 26.3.1. Solo i simboli esportati dal aspose.note pacchetto sono documentati qui. Qualsiasi cosa sotto aspose.note._internal è un dettaglio di implementazione e può cambiare senza preavviso.

ImageRenderOptions: pip install aspose-note (core) o pip install "aspose-note[pdf]" (con esportazione PDF)

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

ImageRenderOptions

Documento e Traversal

ImageRenderOptionsImageRenderOptions
DocumentOggetto documento radice. Carica un .one file, itera le pagine e salva in PDF.
DocumentVisitorBase astratta per l’attraversamento dell’albero del documento mediante il pattern visitor.
NodeClasse base per tutti i nodi del documento.
CompositeNodeClasse base per i nodi che possono contenere nodi figli.

Struttura del documento

ImageRenderOptionsImageRenderOptions
PageRappresenta una pagina OneNote.
TitleBlocco del titolo della pagina contenente TitleText, TitleDate, TitleTime.
OutlineContenitore posizionale per i nodi OutlineElement.
OutlineElementContenitore foglia; contiene RichText, Image, Table, AttachedFile.

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
RichTextBlocco di testo con sequenze di formattazione, tag e collegamenti ipertestuali.
TextRunSingolo segmento di testo formattato all’interno di un RichText.
TextStyleProprietà di formattazione per un TextRun.
ImageImmagine incorporata con byte grezzi e metadati.
AttachedFileAllegato di file incorporato con byte grezzi.
TableTabella con righe, celle e larghezze delle colonne.
TableRowUna riga all’interno di una Tabella.
TableCellUna cella all’interno di una TableRow; contiene content nodes.
NoteTagTag OneNote (stella, casella di controllo, ecc.) allegato a un content node.
NumberListMetadati della lista numerata su un OutlineElement.

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
LoadOptionsOpzioni per caricare un .one file.
SaveOptionsClasse base per le opzioni di salvataggio.
PdfSaveOptionsOpzioni di salvataggio specifiche per PDF (icone dei tag).

Stub di compatibilità

ImageRenderOptionsImageRenderOptions
LicenseStub di compatibilità: SetLicense() non fa nulla in questa implementazione FOSS.
MeteredStub di compatibilità: SetMeteredKey() non fa nulla in questa implementazione FOSS.

Dettagli della classe

ImageRenderOptions

La classe documento radice. Carica un .one file da un percorso, un pathlib.Path, o un flusso binario.

from aspose.note import Document, LoadOptions

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

Parametri del costruttore:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
source`strPath
load_options`LoadOptionsNone`

ImageRenderOptions:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
DisplayName`strNone`
CreationTime`datetimeNone`
FileFormatFileFormatIndicazione approssimativa della versione del formato file OneNote

ImageRenderOptions:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Count()() -> intNumero di pagine figlio dirette
GetPageHistory(page)(Page) -> list[Page]ImageRenderOptions [page] (stub; cronologia completa non ancora implementata)
DetectLayoutChanges()() -> NoneStub di compatibilità; nessuna operazione
Save(target, format_or_options)`(strPath
Accept(visitor)(DocumentVisitor) -> NoneInvoca il visitor traversal
for page in docN/AItera il figlio diretto Page nodi

Document.FileFormat nota: La proprietà fornisce un’indicazione di massima della versione del formato file OneNote. Il FileFormat l’enum ha tre valori: OneNote2010, OneNoteOnline, e OneNote2007.

Document.Save() supporto stream: target può essere un flusso binario (io.BytesIO, handle di file aperto in modalità scrittura binaria, ecc.). Questo è confermato dalla suite di test: doc.Save(io.BytesIO(), PdfSaveOptions(SaveFormat.Pdf)).

DocumentVisitor

Classe base astratta per il traversal con pattern visitor. Sovrascrivi i metodi visit di cui hai bisogno:

ImageRenderOptionsChiamato quando
VisitDocumentStart(doc)Entrando in un nodo Document
VisitDocumentEnd(doc)Uscendo da un nodo Document
VisitPageStart(page)Entrando in un nodo Page
VisitPageEnd(page)Uscendo da un nodo Page
VisitTitleStart(title)Entrando in un nodo Title
VisitTitleEnd(title)Uscendo da un nodo Title
VisitOutlineStart(outline)Entrando in un nodo Outline
VisitOutlineEnd(outline)Uscendo da un nodo Outline
VisitOutlineElementStart(oe)Entrando in un nodo OutlineElement
VisitOutlineElementEnd(oe)Uscendo da un nodo OutlineElement
VisitRichTextStart(rt)Entrando in un nodo RichText
VisitRichTextEnd(rt)Uscendo da un nodo RichText
VisitImageStart(img)Entrando in un nodo Image
VisitImageEnd(img)Uscendo da un nodo Image

ImageRenderOptions

Classe base per tutti i nodi dell’albero del documento.

Proprietà / MetodoImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`
Accept(visitor)(DocumentVisitor) -> NoneInvia il visitatore per questo nodo

CompositeNode

ImageRenderOptions Node. Aggiunge la gestione dei figli:

Proprietà / MetodoImageRenderOptions
FirstChildPrimo nodo figlio, oppure None
LastChildUltimo nodo figlio, oppure None
AppendChildLast(node)Aggiungi un nodo figlio alla fine; imposta node.ParentNode = self
AppendChildFirst(node)Aggiungi un nodo figlio all’inizio
InsertChild(index, node)Inserisci un figlio nella posizione indicata
RemoveChild(node)Rimuovi un nodo figlio; imposta node.ParentNode = None
GetEnumerator()Restituisce un iteratore sui figli diretti
for child in nodeItera i figli diretti
GetChildNodes(Type)(Type) -> list[Type]:ricerca ricorsiva, in profondità dell’intero sottoalbero includendo self

ImageRenderOptions

ImageRenderOptions CompositeNode. Rappresenta una pagina OneNote.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Title`TitleNone`
Author`strNone`
CreationTime`datetimeNone`
LastModifiedTime`datetimeNone`
Level`intNone`

ImageRenderOptions:

ImageRenderOptionsImageRenderOptions
Clone(deep=False)Restituisce una clonazione superficiale o profonda della pagina

ImageRenderOptions

ImageRenderOptions CompositeNode. Contiene il blocco titolo di una Page.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
TitleText`RichTextNone`
TitleDate`RichTextNone`
TitleTime`RichTextNone`

ImageRenderOptions

ImageRenderOptions CompositeNode. Un contenitore posizionale per OutlineElement nodi.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
X`floatNone`
Y`floatNone`
Width`floatNone`

OutlineElement

ImageRenderOptions CompositeNode. Un contenitore foglia che contiene nodi di contenuto.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
IndentLevelintProfondità di nidificazione (0 = più esterno)
NumberList`NumberListNone`
Tagslist[NoteTag]Tag OneNote associati a questo elemento

RichText

ImageRenderOptions CompositeNode. Un blocco di testo formattato.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
TextstrStringa di testo semplice completa (tutte le sequenze concatenate)
Runslist[TextRun]Elenco ordinato di segmenti formattati
FontSize`floatNone`
Tagslist[NoteTag]Tag OneNote associati a questo blocco

ImageRenderOptions:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Append(text, style=None)`(str, TextStyleNone) -> RichText`
Replace(old_value, new_value)(str, str) -> NoneSostituzione di stringa in memoria su Text; non aggiorna Runs

TextRun

ImageRenderOptions Node. Un singolo segmento di testo formattato.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
TextstrIl contenuto testuale del segmento (predefinito "")
StyleTextStyleProprietà di formattazione
Start`intNone`
End`intNone`

TextStyle

ImageRenderOptions Node. Proprietà di formattazione per carattere per un TextRun.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
BoldboolFalseImageRenderOptions
ItalicboolFalseImageRenderOptions
UnderlineboolFalseImageRenderOptions
StrikethroughboolFalseImageRenderOptions
SuperscriptboolFalseImageRenderOptions
SubscriptboolFalseImageRenderOptions
FontName`strNone`None
FontSize`floatNone`None
FontColor`intNone`None
HighlightColor`intNone`None
LanguageId`intNone`None
IsHyperlinkboolFalseSe questo segmento è un collegamento ipertestuale
HyperlinkAddress`strNone`None

ImageRenderOptions

ImageRenderOptions CompositeNode. Un’immagine incorporata.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`
BytesbytesDati grezzi dell’immagine (predefinito b"")
Width`floatNone`
Height`floatNone`
AlternativeTextTitle`strNone`
AlternativeTextDescription`strNone`
HyperlinkUrl`strNone`
Tagslist[NoteTag]Tag di OneNote allegati a questa immagine

ImageRenderOptions:

ImageRenderOptionsImageRenderOptions
Replace(image)ImageRenderOptions Bytes e FileName da un altro Image nodo in questo

AttachedFile

ImageRenderOptions CompositeNode. Un allegato di file incorporato.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`
BytesbytesDati grezzi del file (predefinito b"")
Tagslist[NoteTag]Tag di OneNote allegati a questo allegato

ImageRenderOptions

ImageRenderOptions CompositeNode. Una tabella all’interno di un OutlineElement.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
Columnslist[float][]Larghezza di ogni colonna in punti
IsBordersVisibleboolTrueSe i bordi della tabella sono visibili
Tagslist[NoteTag][]Tag OneNote associati a questa tabella

TableRow

ImageRenderOptions CompositeNode. Una riga all’interno di una Table. Itera GetChildNodes(TableCell) per accedere alle celle.

TableCell

ImageRenderOptions CompositeNode. Una cella all’interno di una TableRow. Contiene RichText, Image, e altri nodi di contenuto.

NoteTag

ImageRenderOptions Node. Un tag OneNote collegato a un nodo di contenuto.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
shape`intNone`None
label`strNone`None
text_color`intNone`None
highlight_color`intNone`None
created`intNone`None
completed`intNone`None

Nota del timestamp: created e completed sono timestamp interi grezzi analizzati dal formato binario MS-ONE, non datetime oggetti.

Metodi di fabbrica:

ImageRenderOptionsImageRenderOptions
NoteTag.CreateYellowStar()Crea un NoteTag(shape=None, label="Yellow Star")

NumberList

ImageRenderOptions Node. Metadati di elenco numerato o puntato su un OutlineElement.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
Format`strNone`None
Restart`intNone`None
IsNumberedboolFalseVero per elenchi ordinati (numerati)

LoadOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
DocumentPassword`strNone`None
LoadHistoryboolFalseCampo di compatibilità API; non utilizzato funzionalmente in v26.3.1

SaveOptions

Classe base per tutte le opzioni di salvataggio. Argomento posizionale obbligatorio.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
SaveFormatSaveFormatFormato di salvataggio di destinazione

PdfSaveOptions

ImageRenderOptions SaveOptions. Configurazione di esportazione specifica per PDF. Costruire con PdfSaveOptions(SaveFormat.Pdf).

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
PageIndexint0Il campo esiste; non inoltrato all’esportatore PDF in v26.3.1: non ha alcun effetto sull’output
PageCount`intNone`None
TagIconDir`strNone`None
TagIconSize`floatNone`None
TagIconGap`floatNone`None

PageIndex / PageCount avvertenza: Questi campi sono dichiarati su PdfSaveOptions per compatibilità API, ma il Document.Save() implementazione in v26.3.1 non legge né li inoltra all’esportatore PDF. Tutte le pagine vengono sempre esportate.

Licenza e a consumo

Stub di compatibilità esportati per la compatibilità della forma dell’API con Aspose.Note per .NET. Tutti i metodi sono no-op in questa implementazione 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

Non è necessaria alcuna chiave di licenza per utilizzare qualsiasi funzionalità di Aspose.Note FOSS per Python.

ImageRenderOptions

Riferimento completo dell’enumerazione: ImageRenderOptions

SaveFormat

ImageRenderOptionsImageRenderOptions
SaveFormat.PdfEsportazione PDF: implementata; richiede pip install "aspose-note[pdf]"
SaveFormat.OneFormato OneNote: dichiarato solo; genera UnsupportedSaveFormatException

FileFormat

Valori enum che rappresentano la versione del formato file OneNote. Document.FileFormat fornisce un’indicazione al meglio delle possibilità.

ImageRenderOptionsValore stringa
FileFormat.OneNote2010"onenote2010"
FileFormat.OneNoteOnline"onenoteonline"
FileFormat.OneNote2007"onenote2007"

HorizontalAlignment

ImageRenderOptionsValore stringa
HorizontalAlignment.Left"left"
HorizontalAlignment.Center"center"
HorizontalAlignment.Right"right"

NodeType

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

ImageRenderOptions

Riferimento completo all’eccezione: ImageRenderOptions

ImageRenderOptionsImageRenderOptions
AsposeNoteErrorClasse base per tutte le eccezioni Aspose.Note FOSS
FileCorruptedExceptionImageRenderOptions .one file non può essere analizzato (binario corrotto o malformato)
IncorrectDocumentStructureExceptionLa struttura del file non è valida o non è supportata
IncorrectPasswordExceptionGenerato quando LoadOptions.DocumentPassword è impostato; i documenti crittografati non sono supportati
UnsupportedFileFormatExceptionIl formato del file non è riconosciuto; espone un FileFormat campo (string)
UnsupportedSaveFormatExceptionIl richiesto SaveFormat non è implementato in questa versione

Vedi anche

 Italiano