NoteTag — Aspose.Note FOSS for Python API Reference

Klass: NoteTag

ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import NoteTag ImageRenderOptions: Node

NoteTag representerar en OneNote‑taggikon (stjärna, kryssruta, viktig markör osv.) som är bifogad till en innehållsnod. Taggar visas på RichText, Image, AttachedFile, OutlineElement, och Table noder via deras .Tags egenskap.


ImageRenderOptions

Alla egenskaper är skrivskyddade och speglar värden som läses direkt från det binära MS-ONE‑formatet.

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

Ärvt från Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`

Tidsstämpel Notering

created och completed är råa heltalstidsstämplar som tolkas från MS-ONE-binärformatet. De är inte datetime objekt. Om du behöver arbeta med dem som Python datum/tider, konsultera MS-ONE-filformatsspecifikationen för konverteringsformeln.


Fabrikmetoder

NoteTag.CreateYellowStar()

tag = NoteTag.CreateYellowStar() -> NoteTag

Returnerar en ny NoteTag med shape=None och label="Yellow Star". Användbart när man konstruerar dokument programatiskt.


Exempel på användning

Lista alla taggade element i ett dokument

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

Filtrera efter ofullständiga “To Do”-taggar

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

None-säkerhet

label, shape, text_color, highlight_color, created, och completed kan alla vara None. Se upp innan användning. Tags listor på innehållsnoder är alltid listor (aldrig None), men kan vara tomt.


Se även

 Svenska