Aspose.Note FOSS за Python

Тази референция обхваща цялата публична API повърхност на aspose-note версия 26.3.1. само символи, изнасяни от aspose.note Всичко, което се съдържа в това пакетно съобщение е документирано тук. aspose.note._internal е подробност за изпълнението и може да се промени без предизвестие.

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

Внос на продукти от други държави членки: from aspose.note import Document, RichText, ...


Класове

Install: pip install aspose-note (core) or pip install "aspose-note[pdf]" (with PDF export)

Документ и преминаване през него

КласътОписание на състоянието
DocumentRoot документ обект. Представя OneNote документ; итерации страници и износ на PDF.
DocumentVisitorАбстрактна база за преминаване на паттерн от посетители в дървото на документа.
NodeБазов клас за всички документни възли.
CompositeNodeБазов клас за възли, които могат да съдържат деца.

Структура на документа

КласътОписание на състоянието
PageПредставя страница OneNote.
TitleБлок заглавие на страница, съдържащ TitleText, TitleDate,TitleTime.
OutlineПозиционен контейнер за OutlineElement възли.
OutlineElementЛистово съдче; съдържа RichText, Image, Table, AttachedFile.

Съдържание на документа

КласътОписание на състоянието
RichTextТекстови блок с форматиране, теги и хипервръзки.
TextRunЕдин форматиран текстов сегмент в рамките на RichText.
TextStyleФорматиране на свойства за TextRun.
ImageВградено изображение с сурови байтове и метаданни.
AttachedFileВграден файлов прилог с сурови байтове.
TableТаблица с широчина на редове, клетки и колони.
TableRowРед в рамките на маса.
TableCellКлетка в TableRow; съдържа съдържание на възли.
NoteTagOneNote етикет (звезда, квадратче за отметка и т.н.) прикрепен към възел на съдържание.
NumberListНомерирани метаданни от списък на OutlineElement.

Възможности за избор

КласътОписание на състоянието
LoadOptionsВъзможности за натоварване на а .one - Да, сър.
SaveOptionsБазов клас за опции за запазване.
PdfSaveOptions (вж. опции и параметри)Класа опции за износ на документи: контролира компресията на изображенията, качеството в JPEG и настройките на страниците за PDF.

Съвместимостни колонки

КласътОписание на състоянието
LicenseСъвместимост: SetLicense() е без операция в тази реализация на FOSS.
MeteredСъвместимост: SetMeteredKey() е без операция в тази реализация на FOSS.

Детайли за класа

Документът

Класата на коренния документ. .one файл от пътека за файлове, а pathlib.Path,или двоичен поток.

from aspose.note import Document, LoadOptions

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

Параметри на конструктора:

Параметър:Тип на изпитванеОписание на състоянието
source`strPath
load_options`LoadOptionsNone`

Свойства на веществата:

ИмотътТип на изпитванеОписание на състоянието
FileFormatFileFormatПоказание за най-добрият опит на формата на файла OneNote

Методи за изчисляване на данните:

Методът:ПодписътОписание на състоянието
GetPageHistory(page)(Page) -> PageHistoryВръщане на средства [page] (стаб; пълната история все още не е внедрена)
DetectLayoutChanges()() -> NoneСъвместимост; без операция
Save(target, format_or_options)`(strPath
Accept(visitor)(DocumentVisitor) -> NoneПризоваване на преминаването на посетителите
for page in docN/AИтеративно пряко дете Page възела

Document.FileFormat бележка:: Свойството дава най-доброто указание за формата на файла OneNote. FileFormat enum има три стойности: OneNote2010, OneNoteOnline, и OneNote2007.

Document.Save() Подкрепа за потока: target може да бъде двоичен поток (io.BytesIO, файлов ръководство, отворено в режим на двоично записване и т.н.).


DocumentVisitor

Абстрактен базов клас за преминаване на посетителски модели. Прехвърляне на необходимите ви методи:

Методът:Обади се, когато…
VisitDocumentStart(doc)Влизане на възел от документ
VisitDocumentEnd(doc)Оставяне на възел за документ
VisitPageStart(page)Влизане на страничен възел
VisitPageEnd(page)Оставяне на страничен възел
VisitTitleStart(title)Вписване на възел за заглавие
VisitTitleEnd(title)Оставяне на възел за заглавие
VisitOutlineStart(outline)Влизане на възел за очертания
VisitOutlineEnd(outline)Оставяне на възел за очертания
VisitOutlineElementStart(oe)Влизане в възел OutlineElement
VisitOutlineElementEnd(oe)Оставяне на OutlineElement възел
VisitRichTextStart(rt)Влизане в възел RichText
VisitRichTextEnd(rt)Оставяне на RichText възел
VisitImageStart(img)Влизане на възел за изображение
VisitImageEnd(img)Оставяне на възел за изображение

Кръголов възел

Базов клас за всички възела на дървото.

Свойство / методТип на изпитванеОписание на състоянието
ParentNode`NodeNone`
Document`DocumentNone`
Accept(visitor)(DocumentVisitor) -> NoneИзпращане на посетители за този възел

CompositeNode

Разширява се Node.Добавя се:

Свойство / методОписание на състоянието
FirstChildПървият детски възел или None
LastChildПоследният детски възел или None
AppendChildLast(node)Добавете дете възел в края; набори node.ParentNode = self
AppendChildFirst(node)Добавяне на дете в началото
InsertChild(index, node)Вмъкнете дете в дадена позиция.
RemoveChild(node)Да премахне подчинен възел; набори node.ParentNode = None
GetEnumerator()Връща итератор върху директни деца.
for child in nodeИтеративни директни деца
GetChildNodes(Type)(Type) -> list[Type]: рекурсивно, първо в дълбочина търсене на цялото поддърво, включително: self

Страница

Разширява се CompositeNode. Представя страница OneNote.

ИмотътТип на изпитванеОписание на състоянието
Title`TitleNone`
Author`strNone`
CreationTime`datetimeNone`
LastModifiedTime`datetimeNone`
Level`intNone`

Методи за изчисляване на данните:

Методът:Описание на състоянието
Clone(deep=False)Върнете плитък или дълбок клон на страницата

Заглавие:

Разширява се CompositeNode.Задържа титулния блок на “А” Page.

ИмотътТип на изпитванеОписание на състоянието
TitleText`RichTextNone`
TitleDate`RichTextNone`
TitleTime`RichTextNone`

Оригинални данни

Разширява се CompositeNode.Позиционен контейнер за OutlineElement възела.

ИмотътТип на изпитванеОписание на състоянието
HorizontalOffset`floatNone`
VerticalOffset`floatNone`
MaxWidth`floatNone`
MaxHeight`floatNone`
MinWidth`floatNone`
ReservedWidth`floatNone`
IndentPosition`floatNone`

OutlineElement

Разширява се CompositeNode.Контейнер с листа, който съдържа възела.

ИмотътТип на изпитванеОписание на състоянието
NumberList`NumberListNone`

RichText

Разширява се Node.- Блок от стилизиран текст.

ИмотътТип на изпитванеОписание на състоянието
TextstrПълен текст на синхрон (всички цикли са свързани)
TextRunslist[TextRun]Поръчен списък на форматираните сегменти
Tagslist[NoteTag]OneNote етикети, прикрепени към този блок

Методи за изчисляване на данните:

Методът:ПодписътОписание на състоянието
Append(text, style=None)`(str, TextStyleNone) -> RichText`
Replace(old_value, new_value)(str, str) -> NoneЗамяната на вградените стълбове от паметта върху Text; не актуализира TextRuns

TextRun

Един форматиран текстов сегмент в рамките на: RichText.TextRuns.

ИмотътТип на изпитванеОписание на състоянието
TextstrТекстовото съдържание на сегмента (по подразбиране) "")
StyleTextStyleСвойства на форматиране

TextStyle

Свойства за форматиране на всеки символ за TextRun.

ИмотътТип на изпитванеПо подразбиране:Описание на състоянието
IsBoldboolFalseСмело.
IsItalicboolFalseКурсиво
IsUnderlineboolFalseПодчертаване на
IsStrikethroughboolFalseПродължително действие
IsSuperscriptboolFalseНаграден текст
IsSubscriptboolFalseПодписване на документа
FontName`strNone`None
FontSize`floatNone`None
FontColor`intNone`None
Highlight`intNone`None
Language`intNone`None
IsHyperlinkboolFalseДали това е хипервръзка.
HyperlinkAddress`strNone`None

Снимка

Разширява се CompositeNode.Вграден образ.

ИмотътТип на изпитванеОписание на състоянието
FileName`strNone`
FilePath`strNone`
Format`strNone`
BytesbytesНеобработени данни за байтове на изображение (по подразбиране) b"")
OriginalWidth`floatNone`
OriginalHeight`floatNone`
Alignment`HorizontalAlignmentNone`
Tagslist[NoteTag]OneNote етикети, свързани с това изображение

Методи за изчисляване на данните:

Методът:Описание на състоянието
Replace(image)Изключено. Bytes и в) FileName от друг. Image възел в този.

AttachedFile

Разширява се Node.Вграден файл с приложения.

ИмотътТип на изпитванеОписание на състоянието
FileName`strNone`
BytesbytesНеобработени данни от файл (по подразбиране) b"")
Tagslist[NoteTag]OneNote етикети, прикрепени към този файл.

Таблица 1

Разширява се CompositeNode.Таблица в OutlineElement.

ИмотътТип на изпитванеПо подразбиране:Описание на състоянието
Columnslist[TableColumn][]Списък на метаданните от колони; всяка TableColumn има: .Width (плава) и .LockedWidth - Какво?
Tagslist[NoteTag][]OneNote етикети, прикрепени към тази таблица

TableRow

Разширява се CompositeNode. ред в рамките на Table.Итерация GetChildNodes(TableCell) за достъп до клетки.


TableCell

Разширява се CompositeNode.Клетка в рамките на една клетка. TableRow.Съдържа: RichText, Image, и други съдържателни възли.


NoteTag

Тэг OneNote, прикрепен към възел за съдържание.

ИмотътТип на изпитванеПо подразбиране:Описание на състоянието
Icon`intNone`None
Label`strNone`None
FontColor`intNone`None
Highlight`intNone`None
CreationTime`datetimeNone`None
CompletedTime`datetimeNone`None
StatusTagStatusПроизведени от:TagStatus.Completed ако: CompletedTime е зададен, друго TagStatus.Open

Производствени методи:

Методът:Описание на състоянието
NoteTag.CreateYellowStar(label=None)Създава се: NoteTag(Label="Yellow Star", Icon=13)
NoteTag.CreateQuestionMark(label=None)Създава се: NoteTag(Label="Question Mark", Icon=15)
NoteTag.CreateMusicalNote(label=None)Създава се: NoteTag(Label="Musical Note", Icon=121)

NumberList

Метаданни от списък с номера или букети на OutlineElement.

ИмотътТип на изпитванеПо подразбиране:Описание на състоянието
Format`strNone`None
NumberFormat`strNone`None
Font`strNone`None
FontSize`floatNone`None
FontColor`intNone`None
IsBoldboolFalseГоловочервено тегло за предписанието на списъка
IsItalicboolFalseКурсивен стил за предписанието на списъка
Restart`intNone`None

LoadOptions

ИмотътТип на изпитванеПо подразбиране:Описание на състоянието
DocumentPassword`strNone`None
LoadHistoryboolFalseПоле за съвместимост с API; не се използва функционално в версия 26.3.1

SaveOptions

Базов клас за опции за запазване.

ИмотътТип на изпитванеОписание на състоянието
SaveFormatSaveFormatФормат на запазване на целевата цел

PdfSaveOptions

Разширява се SaveOptions.Конфигурация за износ, специфична за PDF. Създаване с PdfSaveOptions() (всички аргументи са само за ключови думи с депонирани).

ИмотътТип на изпитванеПо подразбиране:Описание на състоянието
PageIndexint0Поле съществува; не е изпратено на износителя PDF в версия 26.3.1: няма ефект върху продукцията.
PageCount`intNone`None
ImageCompression`AnyNone`None
JpegQuality`intNone`None
PageSettings`AnyNone`None
PageSplittingAlgorithm`AnyNone`None

PageIndex / PageCount Предупреждение::Тези полета се декларират на: PdfSaveOptions за съвместимост с API, но Document.Save() Използването в версия 26.3.1 не се прилага или ги препраща на PDF експортера. Всички страници винаги са изнесени.


Лицензия и измерване

Съвместимостни коренници, изнесени за съвместим формат на API с Aspose.Note за .NET. Всички методи са без операции в тази реализация на 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

Не е необходим лицензионен ключ за използване на функция от Aspose.Note FOSS for Python.


Изброявания

Пълен преброяване на референтния номер: Изброявания

SaveFormat

СтойностОписание на състоянието
SaveFormat.PdfPDF износ: изпълнен; изисква pip install "aspose-note[pdf]"

FileFormat

Енуми стойности, представляващи версията на формата на файла OneNote. Document.FileFormat дава индикация за най-добър опит.

СтойностСтойност на нишката
FileFormat.OneNote2010"onenote2010"
FileFormat.OneNoteOnline"onenoteonline"
FileFormat.OneNote2007"onenote2007"

HorizontalAlignment

СтойностСтойност на нишката
HorizontalAlignment.Left"left"
HorizontalAlignment.Center"center"
HorizontalAlignment.Right"right"

NodeType

СтойностСтойност на нишката
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"

Изключения

Пълен референтен номер за изключение: Изключения

ИзключениеОписание на състоянието
AsposeNoteErrorБазов клас за всички Aspose.Note FOSS изключения
FileCorruptedExceptionСъветът на ЕС .one файлът не може да бъде анализиран (покварен или неправилно оформен двоичен)
IncorrectDocumentStructureExceptionСтруктурата на файла е невалидна или не поддържана.
IncorrectPasswordExceptionПодигнато когато: LoadOptions.DocumentPassword е зададен; не се поддържат криптирани документи
UnsupportedFileFormatExceptionФорматът на файла не е разпознат; излагане на FileFormat поле (струнка)
UnsupportedSaveFormatExceptionЗаявените от Комисията SaveFormat не е внедрена в тази версия.

Вижте също:

 Български