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.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
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 |
Herda de Node
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
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() -> NoteTagRetorna 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
- ImageRenderOptions: classe base
- RichText: nós de texto que carregam tags
- AttachedFile: nós de anexo que carregam tags
- ImageRenderOptions: nós de imagem que carregam tags
- Guia do Desenvolvedor