Title — Aspose.Note FOSS for Python API Reference

Classe: Title

ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import Title ImageRenderOptions: CompositeNode

Title contém o bloco de título de um Page. Ele está sempre acessível como page.Title e também é o primeiro nó filho na lista de filhos da página (inserido via AppendChildFirst durante o carregamento do documento). Ele contém até três RichText filhos: TitleText, TitleDate, e TitleTime.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
TitleText`RichTextNone`ImageRenderOptions
TitleDate`RichTextNone`ImageRenderOptions
TitleTime`RichTextNone`ImageRenderOptions

Herda de CompositeNode

Propriedade / MétodoImageRenderOptions
FirstChildPrimeiro filho direto (normalmente o TitleText RichText nó)
LastChildÚltimo filho direto
AppendChildLast(node)Adicionar um nó filho
GetChildNodes(Type)Busca em profundidade recursiva
for child in titleIterar filhos diretos

Herda de Node

ImageRenderOptionsImageRenderOptions
ParentNodeO contêiner Page
DocumentA raiz Document

ImageRenderOptions

Accept(visitor)

title.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitTitleStart(title), visita recursivamente o filho RichText nós, então VisitTitleEnd(title).


Exemplos de Uso

Ler o título de uma página

from aspose.note import Document, Page

doc = Document("MyNotes.one")
for page in doc.GetChildNodes(Page):
    title = page.Title
    if title and title.TitleText:
        print("Title:", title.TitleText.Text)
    if title and title.TitleDate:
        print("Date:", title.TitleDate.Text)
    if title and title.TitleTime:
        print("Time:", title.TitleTime.Text)

Auxiliar de extração segura de título

from aspose.note import Document, Page

def get_title(page: Page) -> str:
    if page.Title and page.Title.TitleText:
        return page.Title.TitleText.Text
    return "(untitled)"

doc = Document("MyNotes.one")
for page in doc.GetChildNodes(Page):
    print(get_title(page))

Acesse o nó de título via GetChildNodes

Title é um nó filho real no Page subárvore, portanto pode ser encontrado com GetChildNodes:

from aspose.note import Document, Page, Title

doc = Document("MyNotes.one")
for page in doc.GetChildNodes(Page):
    titles = page.GetChildNodes(Title)
    if titles:
        t = titles[0]
        print("TitleText:", t.TitleText.Text if t.TitleText else None)

Use o visitante para coletar o texto do título

from aspose.note import Document, DocumentVisitor, Title

class TitleCollector(DocumentVisitor):
    def __init__(self):
        self.titles = []

    def VisitTitleStart(self, title: Title) -> None:
        if title.TitleText:
            self.titles.append(title.TitleText.Text)

doc = Document("MyNotes.one")
collector = TitleCollector()
doc.Accept(collector)
print(collector.titles)

Segurança contra None

page.Title ele mesmo pode ser None para páginas sem metadados de título. TitleDate e TitleTime são None quando não estiver presente. Sempre proteja:

text = page.Title.TitleText.Text if page.Title and page.Title.TitleText else ""

Veja Também

 Português