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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
TitleText | `RichText | None` | ImageRenderOptions |
TitleDate | `RichText | None` | ImageRenderOptions |
TitleTime | `RichText | None` | ImageRenderOptions |
Herda de CompositeNode
| Propriedade / Método | ImageRenderOptions |
|---|---|
FirstChild | Primeiro 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 title | Iterar filhos diretos |
Herda de Node
| ImageRenderOptions | ImageRenderOptions |
|---|---|
ParentNode | O contêiner Page |
Document | A raiz Document |
ImageRenderOptions
Accept(visitor)
title.Accept(visitor: DocumentVisitor) -> NoneImageRenderOptions 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
- ImageRenderOptions: nó pai; expõe
page.Title - RichText: o tipo de TitleText, TitleDate, TitleTime
- DocumentVisitor:
VisitTitleStart/VisitTitleEnd