NoteTag — Aspose.Note FOSS for Python API Reference

Classe: NoteTag

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

NoteTag representa um ícone de tag do OneNote (estrela, caixa de seleção, marcador importante, etc.) que está anexado a um nó de conteúdo. As tags aparecem em RichText, Image, AttachedFile, OutlineElement, e Table nós via seus .Tags propriedade.


ImageRenderOptions

Todas as propriedades são somente leitura e refletem valores analisados diretamente do formato binário MS-ONE.

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

Herda de Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`

Nota de Carimbo de Tempo

created e completed são timestamps inteiros brutos analisados a partir do formato binário MS-ONE. Eles são não datetime objetos. Se precisar trabalhar com eles como Python datetimes, consulte a especificação do formato de arquivo MS-ONE para a fórmula de conversão.


Métodos de Fábrica

NoteTag.CreateYellowStar()

tag = NoteTag.CreateYellowStar() -> NoteTag

Retorna um novo NoteTag com shape=None e label="Yellow Star". Útil ao construir documentos programaticamente.


Exemplo de Uso

Listar todos os elementos marcados em um documento

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

Filtrar tags “To Do” incompletas

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

Segurança contra None

label, shape, text_color, highlight_color, created, e completed podem todos ser None. Cuidado antes de usar. Tags listas em nós de conteúdo são sempre listas (nunca None), mas podem estar vazias.


Veja Também

 Português