Title

Title — Aspose.Note FOSS for Python API Reference

Clase: Title

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

Title contiene el bloque de título de un Page. Siempre es accesible como page.Title y también es el primer nodo hijo en la lista de hijos de la página (insertado mediante AppendChildFirst durante la carga del documento). Contiene hasta tres RichText hijos: TitleText, TitleDate, y TitleTime.

Examples

Examples	Examples	Examples	Examples
`TitleText`	`RichText	None`	Examples
`TitleDate`	`RichText	None`	Examples
`TitleTime`	`RichText	None`	Examples

Heredado de CompositeNode

Propiedad / Método	Examples
`FirstChild`	Primer hijo directo (típicamente el `TitleText` `RichText` nodo)
`LastChild`	Último hijo directo
`AppendChildLast(node)`	Agregar un nodo hijo
`GetChildNodes(Type)`	Búsqueda en profundidad recursiva
`for child in title`	Iterar hijos directos

Hereda de Node

Examples	Examples
`ParentNode`	El contenedor `Page`
`Document`	La raíz `Document`

Examples

Accept(visitor)

title.Accept(visitor: DocumentVisitor) -> None

Examples VisitTitleStart(title), visita recursivamente al hijo RichText nodos, entonces VisitTitleEnd(title).

Ejemplos de uso

Leer el título de una 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)

Ayudante de extracción segura del 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))

Acceder al nodo de título mediante GetChildNodes

Title es un nodo hijo real en el Page subárbol, por lo que puede encontrarse 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)

Usar visitante para recopilar el texto del 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)

Seguridad contra None

page.Title en sí mismo puede ser None para páginas sin metadatos de título. TitleDate y TitleTime son None cuando no está presente. Siempre protege:

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

Ver también

Examples: nodo padre; expone page.Title
RichText: el tipo de TitleText, TitleDate, TitleTime
DocumentVisitor: VisitTitleStart / VisitTitleEnd