Image
Classe : Image
Examples: aspose.note Examples: from aspose.note import Image Examples: CompositeNode
Image représente une image intégrée stockée dans un fichier OneNote .one Il expose les octets bruts de l’image, le nom de fichier original, les dimensions rendues, le texte alternatif, une URL de lien hypertexte (le cas échéant) et les balises OneNote attachées à l’image.
Examples
| 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 |
Hérité de 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) |
Examples
Replace(image)
img.Replace(image: Image) -> NoneRemplace le contenu de celui-ci Image nœud par le contenu d’un autre Image nœud, en mémoire. Enregistrer de nouveau vers .one n’est pas pris en charge.
Accept(visitor)
img.Accept(visitor: DocumentVisitor) -> NoneExamples VisitImageStart(img) et VisitImageEnd(img) sur le visiteur.
Exemples d’utilisation
Enregistrer toutes les images sur le disque
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)")Détecter le format de l’image à partir des octets
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}")
### Trouver toutes les images liées
doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
if img.HyperlinkUrl:
print(f" Linked image: {img.FileName!r} -> {img.HyperlinkUrl}")Lire le texte alternatif
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}")
### Inspecter les balises sur les images
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}")Images par page
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)")Sécurité None
FileNameestNonelorsqu’aucun nom de fichier n’a été enregistré : fournissez toujours une solution de secours lors de l’écriture sur le disque.Bytesest toujours unbytesobjet et n’est jamaisNone.WidthetHeightsontNonepour les images sans métadonnées de dimension.AlternativeTextTitle,AlternativeTextDescription, etHyperlinkUrlsontNonelorsqu’il n’est pas défini.
Voir aussi
- AttachedFile: pièces jointes intégrées
- NoteTag: tags sur les images
- Examples: ancêtre de Image
- Guide du développeur – Images et fichiers joints
- Comment faire : parcourir le DOM (KB)