Avis sur le FOSS
Python
Title

Title — Aspose.Note FOSS for Python API Reference

Classe : Title

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

Title contient le bloc de titre d’un Page. Il est toujours accessible en tant que page.Title et est également le premier nœud enfant dans la liste des enfants de la page (inséré via AppendChildFirst lors du chargement du document). Il contient jusqu’à trois RichText enfants : TitleText, TitleDate, et TitleTime.

Examples

ExamplesExamplesExamplesExamples
TitleText`RichTextNone`Examples
TitleDate`RichTextNone`Examples
TitleTime`RichTextNone`Examples

Hérité de CompositeNode

Propriété / MéthodeExamples
FirstChildPremier enfant direct (généralement le TitleText RichText nœud)
LastChildDernier enfant direct
AppendChildLast(node)Ajouter un nœud enfant
GetChildNodes(Type)Recherche en profondeur récursive
for child in titleItérer les enfants directs

Hérité de Node

ExamplesExamples
ParentNodeLe contenant Page
DocumentLa racine Document

Examples

Accept(visitor) 

title.Accept(visitor: DocumentVisitor) -> None

Examples VisitTitleStart(title), visite récursivement l’enfant RichText nœuds, puis VisitTitleEnd(title).

Exemples d’utilisation

Lire le titre d’une page 

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)

Assistant d’extraction sécurisée du titre 

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

Accéder au nœud titre via GetChildNodes

Title est un vrai nœud enfant dans le Page sous‑arbre, donc il peut être trouvé avec 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)

Utiliser le visiteur pour collecter le texte du titre 

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)

Sécurité None

page.Title lui‑même peut être None pour les pages sans métadonnées de titre. TitleDate et TitleTime sont None lorsqu’ils ne sont pas présents. Toujours protéger :

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

Voir aussi

 Français