Title

Title — Aspose.Note FOSS for Python API Reference

Classe: Title

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

Title contiene il blocco del titolo di un Page. È sempre accessibile come page.Title ed è anche il primo nodo figlio nell’elenco dei figli della pagina (inserito tramite AppendChildFirst durante il caricamento del documento). Contiene fino a tre RichText figli: TitleText, TitleDate, e TitleTime.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`TitleText`	`RichText	None`	ImageRenderOptions
`TitleDate`	`RichText	None`	ImageRenderOptions
`TitleTime`	`RichText	None`	ImageRenderOptions

Ereditato da CompositeNode

Proprietà / Metodo	ImageRenderOptions
`FirstChild`	Primo figlio diretto (tipicamente il `TitleText` `RichText` nodo)
`LastChild`	Ultimo figlio diretto
`AppendChildLast(node)`	Aggiungi un nodo figlio
`GetChildNodes(Type)`	Ricerca ricorsiva in profondità
`for child in title`	Itera i figli diretti

Ereditato da Node

ImageRenderOptions	ImageRenderOptions
`ParentNode`	Il contenitore `Page`
`Document`	La radice `Document`

ImageRenderOptions

Accept(visitor)

title.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitTitleStart(title), visita ricorsivamente il figlio RichText nodi, poi VisitTitleEnd(title).

Esempi d’uso

Leggi il titolo di una pagina

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)

Helper per l’estrazione sicura del titolo

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

Accedi al nodo del titolo tramite GetChildNodes

Title è un vero nodo figlio nel Page sottostruttura, quindi può essere trovato con 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)

Usa il visitor per raccogliere il testo del titolo

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)

Sicurezza None

page.Title se stesso può essere None per pagine senza metadati del titolo. TitleDate e TitleTime sono None quando non è presente. Sempre proteggi:

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

Vedi anche

ImageRenderOptions: nodo genitore; espone page.Title
RichText: il tipo di TitleText, TitleDate, TitleTime
DocumentVisitor: VisitTitleStart / VisitTitleEnd