Image

Клас: Image

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

Image представляє вбудоване зображення, збережене всередині OneNote .one файл. Воно надає необроблені байти зображення, оригінальне ім’я файлу, відображені розміри, альтернативний текст, URL‑посилання (за наявності) та будь‑які теги OneNote, прикріплені до зображення.

Enumerations

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)`

Enumerations

Replace(image)

img.Replace(image: Image) -> None

Замінює вміст цього Image вузла вмістом іншого Image вузла, в пам’яті. Збереження назад у .one не підтримується.

Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

Enumerations 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}")

Прочитати альтернативний текст

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: теги на зображеннях
Enumerations: предок Image
Посібник розробника зображень та прикріплених файлів
Як: обходити DOM (KB)