NoteTag — Aspose.Note FOSS for Python API Reference

Класс: NoteTag

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

NoteTag представляет значок тега OneNote (звезда, флажок, маркер важности и т.д.), который прикреплён к узлу содержимого. Теги отображаются на RichText, Image, AttachedFile, OutlineElement, и Table узлы через их .Tags свойство.


ImageRenderOptions

Все свойства только для чтения и отражают значения, разобранные непосредственно из двоичного формата MS-ONE.

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

Наследовано от Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`

Примечание к временной метке

created и completed являются необработанными целочисленными метками времени, полученными из двоичного формата MS-ONE. Они не datetime объектами. Если вам нужно работать с ними как с датами и временем Python, обратитесь к спецификации формата файла MS-ONE для формулы преобразования.


Фабричные методы

NoteTag.CreateYellowStar()

tag = NoteTag.CreateYellowStar() -> NoteTag

Возвращает новый NoteTag с shape=None и label="Yellow Star". Полезно при программном построении документов.


Пример использования

Список всех элементов с тегами в документе

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

Фильтрация неполных тегов “To Do”

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

label, shape, text_color, highlight_color, created, и completed могут быть все None. Остерегайтесь при использовании. Tags списки в узлах контента всегда являются списками (никогда None), но могут быть пустыми.


См. также

 Русский