Aspose.Cells СОБДЫЕ
Python
Title

Title — Aspose.Note FOSS for Python API Reference

Класс: Title

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

Title содержит блок заголовка Page. Он всегда доступен как page.Title и также является первым дочерним узлом в списке дочерних элементов страницы (вставленным через AppendChildFirst во время загрузки документа). Он содержит до трёх RichText дочерних элементов: TitleText, TitleDate, и TitleTime.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
TitleText`RichTextNone`ImageRenderOptions
TitleDate`RichTextNone`ImageRenderOptions
TitleTime`RichTextNone`ImageRenderOptions

Унаследовано от CompositeNode

Свойство / МетодImageRenderOptions
FirstChildПервый непосредственный дочерний элемент (обычно TitleText RichText узел)
LastChildПоследний непосредственный дочерний элемент
AppendChildLast(node)Добавить дочерний узел
GetChildNodes(Type)Рекурсивный поиск в глубину
for child in titleИтерировать прямых потомков

Наследовано от Node

ImageRenderOptionsImageRenderOptions
ParentNodeСодержащий Page
DocumentКорень Document

ImageRenderOptions

Accept(visitor) 

title.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions 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 ""

См. также

 Русский