Notes
Python
Title

Title — Aspose.Note FOSS for Python API Reference

Клас: Title

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

Title містить блок заголовка Page. Він завжди доступний як page.Title і також є першим дочірнім вузлом у списку дочірніх елементів сторінки (вставленим через AppendChildFirst під час завантаження документа). Він містить до трьох RichText дочірніх елементів: TitleText, TitleDate, і TitleTime.

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
TitleText`RichTextNone`Enumerations
TitleDate`RichTextNone`Enumerations
TitleTime`RichTextNone`Enumerations

Успадковано від CompositeNode

Властивість / МетодEnumerations
FirstChildПерший безпосередній дочірній елемент (зазвичай TitleText RichText вузол)
LastChildОстанній безпосередній дочірній елемент
AppendChildLast(node)Додати дочірній вузол
GetChildNodes(Type)Рекурсивний пошук у глибину
for child in titleПеребрати прямі дочірні елементи

Успадковано від Node

EnumerationsEnumerations
ParentNodeКонтейнер Page
DocumentКорінь Document

Enumerations

Accept(visitor) 

title.Accept(visitor: DocumentVisitor) -> None

Enumerations VisitTitleStart(title), рекурсивно відвідує дочірній RichText вузли, потім VisitTitleEnd(title).

Приклади використання

Зчитати заголовок сторінки 

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)

Допоміжна функція безпечного отримання заголовка 

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

Отримайте вузол заголовка за допомогою GetChildNodes

Title є реальним дочірнім вузлом у the Page піддерево, щоб його можна було знайти за допомогою 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)

Використайте відвідувача для збору тексту заголовка 

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)

Безпека щодо None

page.Title саме може бути None для сторінок без метаданих заголовка. TitleDate і TitleTime є None коли відсутні. Завжди захищайте:

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

Див. також

  • Enumerations: батьківський вузол; відкриває page.Title
  • RichText: тип TitleText, TitleDate, TitleTime
  • DocumentVisitor: VisitTitleStart / VisitTitleEnd
 Українська