Aspose.Note FOSS for Python

הפנייה הזו מכסה את כל המשטח הציבורי של aspose-note גרסה 26.3.1. רק סמלים שיוצאו מ- aspose.note החבילה מתועדת כאן. כל דבר תחת aspose.note._internal הוא פרט יישום ועלול להשתנות ללא הודעה.

ImageRenderOptions: pip install aspose-note (core) או pip install "aspose-note[pdf]" (עם ייצוא PDF)

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

ImageRenderOptions

מסמך וניווט

ImageRenderOptionsImageRenderOptions
Documentאובייקט מסמך שורש. טען .one קובץ, עבור על דפים, ושמור ל-PDF.
DocumentVisitorבסיס מופשט לניווט בתבנית מבקר של עץ המסמך.
Nodeמחלקת בסיס לכל צמתי המסמך.
CompositeNodeמחלקה בסיסית לצמתים שיכולים להכיל צמתים צאצאים.

מבנה המסמך

ImageRenderOptionsImageRenderOptions
Pageמייצגת דף OneNote.
Titleחסימת כותרת דף המכילה TitleText, TitleDate, TitleTime.
Outlineמכולה מיקומית לצמתי OutlineElement.
OutlineElementמכולת עלה; מכילה RichText, Image, Table, AttachedFile.

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
RichTextבלוק טקסט עם ריצות עיצוב, תגיות וקישורים.
TextRunקטע טקסט מעוצב יחיד בתוך RichText.
TextStyleמאפייני עיצוב עבור TextRun.
Imageתמונה משובצת עם בייטים גולמיים ונתוני מטא.
AttachedFileקובץ מצורף משובץ עם בייטים גולמיים.
Tableטבלה עם שורות, תאים ורוחבי עמודות.
TableRowשורה בתוך טבלה.
TableCellתא בתוך TableRow; מכיל צמתים של תוכן.
NoteTagתג OneNote (כוכב, תיבת סימון, וכו’) מצורף לצומת תוכן.
NumberListמטא‑נתונים של רשימה ממוספרת על OutlineElement.

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
LoadOptionsאפשרויות לטעינת .one קובץ.
SaveOptionsמחלקת בסיס לאפשרויות שמירה.
PdfSaveOptionsאפשרויות שמירה ספציפיות ל-PDF (איקוני תגיות).

תבניות תאימות

ImageRenderOptionsImageRenderOptions
Licenseקוד תואם: SetLicense() הוא פעולה ריקה (no‑op) במימוש ה‑FOSS הזה.
Meteredקוד תואם: SetMeteredKey() הוא פעולה ריקה (no‑op) במימוש ה‑FOSS הזה.

פרטי המחלקה

ImageRenderOptions

מחלקת המסמך הראשית. טען .one קובץ ממסלול קובץ, pathlib.Path, או זרם בינארי.

from aspose.note import Document, LoadOptions

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

פרמטרי הבנאי:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
source`strPath
load_options`LoadOptionsNone`

ImageRenderOptions:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
DisplayName`strNone`
CreationTime`datetimeNone`
FileFormatFileFormatהצגה best-effort של גרסת פורמט הקובץ של OneNote

ImageRenderOptions:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Count()() -> intמספר דפי ילדים ישירים
GetPageHistory(page)(Page) -> list[Page]ImageRenderOptions [page] (stub; היסטוריה מלאה עדיין לא מיושמת)
DetectLayoutChanges()() -> Nonestub תאימות; ללא פעולה
Save(target, format_or_options)`(strPath
Accept(visitor)(DocumentVisitor) -> Noneהפעל מעבר מבקר
for page in docN/Aחזור על ילד ישיר Page צמתים

Document.FileFormat הערה: property מספק הצגה best-effort של גרסת פורמט הקובץ של OneNote. The FileFormat enum מכיל שלוש ערכים: OneNote2010, OneNoteOnline, ו OneNote2007.

Document.Save() תמיכה בזרם: target יכול להיות זרם בינארי (io.BytesIO, מצביע קובץ שנפתח במצב כתיבה בינארית, וכו’). זה מאושר על ידי ערכת הבדיקות: doc.Save(io.BytesIO(), PdfSaveOptions(SaveFormat.Pdf)).

DocumentVisitor

מחלקת בסיס מופשטת לניווט בתבנית מבקר. דרוס את שיטות הביקור שאתה צריך:

ImageRenderOptionsנקרא כאשר
VisitDocumentStart(doc)נכנס לצומת מסמך
VisitDocumentEnd(doc)יוצא מצומת מסמך
VisitPageStart(page)נכנס לצומת דף
VisitPageEnd(page)יוצא מצומת דף
VisitTitleStart(title)נכנס לצומת כותרת
VisitTitleEnd(title)יוצא מצומת כותרת
VisitOutlineStart(outline)נכנס לצומת מתאר
VisitOutlineEnd(outline)יוצא מצומת מתאר
VisitOutlineElementStart(oe)נכנס לצומת רכיב מתאר
VisitOutlineElementEnd(oe)יוצא מצומת רכיב מתאר
VisitRichTextStart(rt)נכנס לצומת טקסט עשיר
VisitRichTextEnd(rt)יוצא מצומת טקסט עשיר
VisitImageStart(img)נכנס לצומת תמונה
VisitImageEnd(img)יוצא מצומת תמונה

ImageRenderOptions

מחלקה בסיסית לכל צמתים בעץ המסמך.

מאפיין / שיטהImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`
Accept(visitor)(DocumentVisitor) -> Noneהפץ מבקר עבור צומת זה

CompositeNode

ImageRenderOptions Node. מוסיף ניהול ילדים:

מאפיין / מתודהImageRenderOptions
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

ImageRenderOptions

ImageRenderOptions CompositeNode. מייצג דף OneNote.

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

ImageRenderOptions:

ImageRenderOptionsImageRenderOptions
Clone(deep=False)החזר עותק רדוד או עמוק של הדף

ImageRenderOptions

ImageRenderOptions CompositeNode. מחזיק את בלוק הכותרת של Page.

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

ImageRenderOptions

ImageRenderOptions CompositeNode. מכולה מיקומית עבור OutlineElement צמתים.

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

OutlineElement

ImageRenderOptions CompositeNode. מכולת עלה שמחזיקה צמתים של תוכן.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
IndentLevelintעומק קידוד (0 = החיצוני ביותר)
NumberList`NumberListNone`
Tagslist[NoteTag]תגיות OneNote המצורפות לאלמנט זה

RichText

ImageRenderOptions CompositeNode. בלוק של טקסט מעוצב.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Textstrמחרוזת טקסט פשוט מלאה (כל הריצות מחוברות יחד)
Runslist[TextRun]רשימה מסודרת של קטעים מעוצבים
FontSize`floatNone`
Tagslist[NoteTag]תגיות OneNote המצורפות לבלוק זה

ImageRenderOptions:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Append(text, style=None)`(str, TextStyleNone) -> RichText`
Replace(old_value, new_value)(str, str) -> NoneIn-memory החלפת מחרוזת על Text; אינו מתעדכן Runs

TextRun

ImageRenderOptions Node. קטע טקסט מעוצב יחיד.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Textstrתוכן הטקסט של הקטע (ברירת מחדל "")
StyleTextStyleמאפייני עיצוב
Start`intNone`
End`intNone`

TextStyle

ImageRenderOptions Node. מאפייני עיצוב לכל תו עבור TextRun.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
BoldboolFalseImageRenderOptions
ItalicboolFalseImageRenderOptions
UnderlineboolFalseImageRenderOptions
StrikethroughboolFalseImageRenderOptions
SuperscriptboolFalseImageRenderOptions
SubscriptboolFalseImageRenderOptions
FontName`strNone`None
FontSize`floatNone`None
FontColor`intNone`None
HighlightColor`intNone`None
LanguageId`intNone`None
IsHyperlinkboolFalseהאם ריצה זו היא קישור היפר-טקסט
HyperlinkAddress`strNone`None

ImageRenderOptions

ImageRenderOptions CompositeNode. תמונה משובצת.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`
Bytesbytesנתוני תמונה גולמיים (ברירת מחדל b"")
Width`floatNone`
Height`floatNone`
AlternativeTextTitle`strNone`
AlternativeTextDescription`strNone`
HyperlinkUrl`strNone`
Tagslist[NoteTag]תגיות OneNote המצורפות לתמונה זו

ImageRenderOptions:

ImageRenderOptionsImageRenderOptions
Replace(image)ImageRenderOptions Bytes ו FileName מאחר Image צומת לתוך זה

AttachedFile

ImageRenderOptions CompositeNode. קובץ מצורף משובץ.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`
Bytesbytesנתוני קובץ גולמיים (ברירת מחדל b"")
Tagslist[NoteTag]תגיות OneNote המצורפות לקובץ המצורף הזה

ImageRenderOptions

ImageRenderOptions CompositeNode. טבלה בתוך OutlineElement.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
Columnslist[float][]רוחב של כל עמודה בנקודות
IsBordersVisibleboolTrueהאם גבולות הטבלה נראים
Tagslist[NoteTag][]תגיות OneNote המצורפות לטבלה זו

TableRow

ImageRenderOptions CompositeNode. שורה בתוך Table. חזור GetChildNodes(TableCell) כדי לגשת לתאים.

TableCell

ImageRenderOptions CompositeNode. תא בתוך TableRow. מכיל RichText, Image, ואלמנטים של תוכן אחרים.

NoteTag

ImageRenderOptions Node. תג OneNote מצורף לאלמנט תוכן.

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

הערת חותמת זמן: created ו completed הם חותמות זמן שלמות גולמיות כפי שנפרשו מתבנית הבינארית של MS-ONE, לא datetime אובייקטים.

מתודות ייצור:

ImageRenderOptionsImageRenderOptions
NoteTag.CreateYellowStar()יוצר NoteTag(shape=None, label="Yellow Star")

NumberList

ImageRenderOptions Node. מטא‑נתונים של רשימה ממוספרת או עם תבליטים על OutlineElement.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
Format`strNone`None
Restart`intNone`None
IsNumberedboolFalseאמת עבור רשימות מסודרות (ממוספרות)

LoadOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
DocumentPassword`strNone`None
LoadHistoryboolFalseשדה תאימות API; אינו משמש פונקציונלית ב‑v26.3.1

SaveOptions

מחלקת בסיס לכל אפשרויות השמירה. ארגומנט מיקום נדרש.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
SaveFormatSaveFormatפורמט שמירה יעד

PdfSaveOptions

ImageRenderOptions SaveOptions. תצורת ייצוא ספציפית ל‑PDF. בנייה עם PdfSaveOptions(SaveFormat.Pdf).

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
PageIndexint0השדה קיים; לא מועבר למייצא PDF ב‑v26.3.1: אין לו השפעה על הפלט
PageCount`intNone`None
TagIconDir`strNone`None
TagIconSize`floatNone`None
TagIconGap`floatNone`None

PageIndex / PageCount אזהרה: השדות האלה מוגדרים ב PdfSaveOptions לתאימות API, אך ה Document.Save() היישום ב‑v26.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 עבור Python.

ImageRenderOptions

הפנייה המלאה למניין: ImageRenderOptions

SaveFormat

ImageRenderOptionsImageRenderOptions
SaveFormat.Pdfייצוא PDF: מיושם; דורש pip install "aspose-note[pdf]"
SaveFormat.Oneפורמט OneNote: הוצהר בלבד; מעלה UnsupportedSaveFormatException

FileFormat

ערכי Enum המייצגים את גרסת פורמט הקובץ של OneNote. Document.FileFormat מספק אינדיקציה במאמץ מיטבי.

ImageRenderOptionsערך מחרוזת
FileFormat.OneNote2010"onenote2010"
FileFormat.OneNoteOnline"onenoteonline"
FileFormat.OneNote2007"onenote2007"

HorizontalAlignment

ImageRenderOptionsערך מחרוזת
HorizontalAlignment.Left"left"
HorizontalAlignment.Center"center"
HorizontalAlignment.Right"right"

NodeType

ImageRenderOptionsערך מחרוזת
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

הפנייה המלאה לשגיאה: ImageRenderOptions

ImageRenderOptionsImageRenderOptions
AsposeNoteErrorמחלקת בסיס לכל השגיאות של Aspose.Note FOSS
FileCorruptedExceptionImageRenderOptions .one לא ניתן לנתח את הקובץ (פגום או בינארי פגום)
IncorrectDocumentStructureExceptionמבנה הקובץ אינו תקין או אינו נתמך
IncorrectPasswordExceptionנוצר כאשר LoadOptions.DocumentPassword מוגדר; מסמכים מוצפנים אינם נתמכים
UnsupportedFileFormatExceptionפורמט הקובץ אינו מזוהה; חושף a FileFormat שדה (string)
UnsupportedSaveFormatExceptionהמתבקש SaveFormat לא מיושם בגרסה זו

ראה גם

 עברית