Image

מחלקה: Image

ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import Image ImageRenderOptions: CompositeNode

Image מייצג תמונה משובצת שנשמרת בתוך OneNote .one קובץ. הוא חושף את בתי התמונה הגולמיים, את שם הקובץ המקורי, את הממדים המוצגים, טקסט alt, כתובת URL של קישור (אם קיימת), וכל תגיות OneNote המצורפות לתמונה.

ImageRenderOptions

Name	Type	Access	Description
`FileName`	`str	None`	Read
`FilePath`	`str	None`	Read
`Format`	`str	None`	Read
`Bytes`	`bytes`	Read	Gets the bytes.
`OriginalWidth`	`float	None`	Read
`OriginalHeight`	`float	None`	Read
`Tags`	`list[NoteTag]`	Read	Gets the tags.
`Alignment`	`HorizontalAlignment	None`	Read/Write
`Width`	``	Read	Gets the width.
`Height`	``	Read	Gets the height.
`HorizontalOffset`	``	Read	Gets the horizontal offset.
`VerticalOffset`	``	Read	Gets the vertical offset.
`IsBackground`	``	Read	Gets the is background.
`LastModifiedTime`	``	Read	Gets the last modified time.
`AlternativeTextTitle`	``	Read	Gets the alternative text title.
`AlternativeTextDescription`	``	Read	Gets the alternative text description.
`HyperlinkUrl`	``	Read	Gets the hyperlink url.
`FirstChild`	`Node	None`	Read
`LastChild`	`Node	None`	Read
`ParentNode`	`Node	None`	Read
`Document`	`Document	None`	Read

יורש מ-CompositeNode / Node

Signature	Description
`init(FileName: str	None, FilePath: str
`Replace(image: Image)`	Replaces the current image data with the provided Image instance
`AppendChildLast(node: TNode)` → `TNode`
`AppendChildFirst(node: TNode)` → `TNode`
`InsertChild(index: int, node: TNode)` → `TNode`
`RemoveChild(node: Node)`
`GetEnumerator()` → `Iterator[Node]`
`GetChildNodes(node_type: type[TNode])` → `list[TNode]`
`Accept(visitor: DocumentVisitor)`

ImageRenderOptions

Replace(image)

img.Replace(image: Image) -> None

מחליף את התוכן של זה Image צומת בתוכן של צומת אחר Image צומת, בזיכרון. שמירה חזרה ל .one לא נתמך.

Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) ו VisitImageEnd(img) על המבקר.

דוגמאות שימוש

שמור את כל התמונות לדיסק

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for i, img in enumerate(doc.GetChildNodes(Image), start=1):
    filename = img.FileName or f"image_{i}.bin"
    with open(filename, "wb") as f:
        f.write(img.Bytes)
    print(f"Saved: {filename}  ({img.Width} x {img.Height} pts)")

זיהוי פורמט תמונה מהבתים

doc = Document(“MyNotes.one”) for img in doc.GetChildNodes(Image): b = img.Bytes if b[:4] == b’\x89PNG’: fmt = “png” elif b[:2] == b’\xff\xd8’: fmt = “jpeg” elif b[:4] == b’GIF8’: fmt = “gif” else: fmt = “bin” print(f" {img.FileName!r} detected as {fmt}")


### מצא את כל התמונות המקושרות

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    if img.HyperlinkUrl:
        print(f"  Linked image: {img.FileName!r} -> {img.HyperlinkUrl}")

קרא טקסט alt

doc = Document(“MyNotes.one”) for img in doc.GetChildNodes(Image): if img.AlternativeTextTitle or img.AlternativeTextDescription: print(f" Alt title: {img.AlternativeTextTitle!r}") print(f" Alt desc: {img.AlternativeTextDescription!r}")


### בדוק תגים על תמונות

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    for tag in img.Tags:
        print(f"  Image tag: label={tag.label!r}  completed={tag.completed}")

תמונות לכל עמוד

from aspose.note import Document, Page, Image

doc = Document("MyNotes.one")
for page_num, page in enumerate(doc.GetChildNodes(Page), start=1):
    images = page.GetChildNodes(Image)
    print(f"Page {page_num}: {len(images)} image(s)")

בטיחות מפני None

FileName הוא None כאשר לא נשמר שם קובץ: תמיד לספק גיבוי בעת כתיבה לדיסק.
Bytes תמיד הוא bytes אובייקט ולעולם לא None.
Width ו Height הם None לתמונות ללא מטא‑נתוני ממדים.
AlternativeTextTitle, AlternativeTextDescription, ו HyperlinkUrl הם None כאשר לא הוגדר.

ראה גם

AttachedFile: קבצים מצורפים משובצים
NoteTag: תגיות על תמונות
ImageRenderOptions: קודמו של Image
מדריך למפתחים של תמונות וקבצים מצורפים
How-to: מעבר על ה-DOM (KB)