NoteTag — Aspose.Note FOSS for Python API Reference
Classe : NoteTag
Examples: aspose.note Examples: from aspose.note import NoteTag Examples: Node
NoteTag représente une icône de balise OneNote (étoile, case à cocher, marqueur important, etc.) qui est attachée à un nœud de contenu. Les balises apparaissent sur RichText, Image, AttachedFile, OutlineElement, et Table nœuds via leurs .Tags propriété.
Examples
Toutes les propriétés sont en lecture seule et reflètent les valeurs analysées directement à partir du format binaire MS-ONE.
| Examples | Examples | Examples | Examples |
|---|---|---|---|
shape | `int | None` | None |
label | `str | None` | None |
text_color | `int | None` | None |
highlight_color | `int | None` | None |
created | `int | None` | None |
completed | `int | None` | None |
Hérité de Node
| Examples | Examples | Examples |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
Note d’horodatage
created et completed sont des horodatages entiers bruts tels qu’extraits du format binaire MS-ONE. Ils sont pas datetime des objets. Si vous devez les manipuler en tant que dates/horaires Python, consultez la spécification du format de fichier MS-ONE pour la formule de conversion.
Méthodes de fabrique
NoteTag.CreateYellowStar()
tag = NoteTag.CreateYellowStar() -> NoteTagRenvoie un nouveau NoteTag avec shape=None et label="Yellow Star". Utile lors de la création de documents de façon programmatique.
Exemple d’utilisation
Lister tous les éléments étiquetés dans un document
from aspose.note import Document, RichText, Image, AttachedFile, OutlineElement
doc = Document("MyNotes.one")
# Tags on RichText
for rt in doc.GetChildNodes(RichText):
for tag in rt.Tags:
print(f"RichText tag: label={tag.label!r} on: {rt.Text.strip()[:40]!r}")
# Tags on Images
for img in doc.GetChildNodes(Image):
for tag in img.Tags:
print(f"Image tag: label={tag.label!r} file={img.FileName!r}")
# Tags on AttachedFiles
for af in doc.GetChildNodes(AttachedFile):
for tag in af.Tags:
print(f"Attachment tag: label={tag.label!r} file={af.FileName!r}")Filtrer les étiquettes “To Do” incomplètes
from aspose.note import Document, RichText
doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
for tag in rt.Tags:
if tag.label and "to do" in tag.label.lower() and tag.completed is None:
print(f"Incomplete TODO: {rt.Text.strip()!r}")Sécurité None
label, shape, text_color, highlight_color, created, et completed peuvent tous être None. Vérifier avant utilisation. Tags les listes sur les nœuds de contenu sont toujours des listes (jamais None), mais peuvent être vides.
Voir aussi
- Examples: classe de base
- RichText: nœuds texte qui portent des balises
- AttachedFile: nœuds pièce jointe qui portent des balises
- Examples: nœuds image qui portent des balises
- Guide du développeur