Image

Luokka: Image

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

Image edustaa OneNoteen upotettua kuvaa, joka on tallennettu. .one tiedosto. Se paljastaa raakatiedoston kuvabittien, alkuperäisen tiedostonimen, renderöidyt mitat, alt-tekstin, hyperlinkin URL:n (jos sellainen on) ja kaikki OneNote-tunnisteet, jotka on liitetty kuvaan.

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

Peritty CompositeNode‑luokalta / 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

Korvaa tämän sisällön Image node, jonka sisältö on toisen Image node, muistissa. Tallentaminen takaisin .one ei ole tuettu.

Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) ja VisitImageEnd(img) vierailijalla.

Käyttöesimerkit

Tallenna kaikki kuvat levylle

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

Tunnista kuvan formaatti tavuista

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


### Etsi kaikki linkitetyt kuvat

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

Lue alt‑teksti

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


### Tutki kuvien tunnisteita

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

Kuvat per sivu

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‑turvallisuus

FileName on None kun tiedostonimeä ei ole tallennettu: tarjoa aina varmistus, kun kirjoitat levylle.
Bytes on aina bytes objekti eikä koskaan None.
Width ja Height ovat None kuville, joilla ei ole dimensiometatietoja.
AlternativeTextTitle, AlternativeTextDescription, ja HyperlinkUrl ovat None kun ei ole asetettu.

Katso myös

AttachedFile: upotetut tiedostoliitteet
NoteTag: kuvien tunnisteet
ImageRenderOptions: Image:n edeltäjä
Kuvien ja liitetiedostojen kehittäjän opas
How-to: DOMin läpikäynti (KB)