NumberList — Aspose.Note FOSS for Python API Reference

Classe: NumberList

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

NumberList contém os metadados de numeração de lista anexados a um OutlineElement. Quando OutlineElement.NumberList não está None, o elemento faz parte de uma lista ordenada ou não ordenada. As propriedades refletem valores brutos analisados a partir do formato binário MS-ONE e são somente leitura; não podem ser definidas pelo usuário em v26.3.1.


ImageRenderOptions

Todas as propriedades são somente leitura.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
Format`strNone`None
Restart`intNone`None
IsNumberedboolFalseTrue para listas ordenadas (numeradas); False para listas com marcadores ou não sequenciais.

Herda de Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`

ImageRenderOptions

  • Dados somente leitura: Format, Restart, e IsNumbered são analisados a partir do arquivo binário. Não há API para modificar a numeração na v26.3.1.
  • Strings de formato: O Format string segue o formato bruto de numeração MS-ONE, não um padrão legível por humanos. Valores comuns incluem strings de formato decimal ("%1.", "%1)") para listas numeradas e caracteres de marcadores ("•", "–") para listas com marcadores.
  • Verificação de presença:Sempre verifique OutlineElement.NumberList is not None antes de acessar este objeto.

Exemplo de Uso

Detectar itens de lista numerada vs com marcadores

from aspose.note import Document, OutlineElement

doc = Document("MyNotes.one")
for oe in doc.GetChildNodes(OutlineElement):
    nl = oe.NumberList
    if nl is None:
        continue  # not a list item
    restart_info = f"  restart={nl.Restart}" if nl.Restart is not None else ""
    print(f"format={nl.Format!r}{restart_info}")

Coletar todos os itens de lista numerada com seu texto

from aspose.note import Document, OutlineElement, RichText

doc = Document("MyNotes.one")
for oe in doc.GetChildNodes(OutlineElement):
    if oe.NumberList is not None:
        texts = [rt.Text for rt in oe.GetChildNodes(RichText) if rt.Text]
        print(" | ".join(texts))

Segurança contra None

Format e Restart pode ser None. IsNumbered é sempre um bool. OutlineElement.NumberList ele mesmo pode ser None — verifique antes de acessar qualquer propriedade.


Veja Também

 Português