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.

ExamplesExamplesExamplesExamples
shape`intNone`None
label`strNone`None
text_color`intNone`None
highlight_color`intNone`None
created`intNone`None
completed`intNone`None

Hérité de Node

ExamplesExamplesExamples
ParentNode`NodeNone`
Document`DocumentNone`

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() -> NoteTag

Renvoie 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

 Français