Title — Aspose.Note FOSS for Python API Reference

类:Title

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

Title 保存标题块的 Page.。它始终可通过 page.Title 并且也是页面子列表中的第一个子节点(通过以下方式插入 AppendChildFirst 在文档加载期间)。它最多包含三个 RichText 子节点:: TitleText, TitleDate,,以及 TitleTime.


Properties

PropertiesPropertiesPropertiesProperties
TitleText`RichTextNone`Properties
TitleDate`RichTextNone`Properties
TitleTime`RichTextNone`Properties

继承自 CompositeNode

属性 / 方法Properties
FirstChild第一个直接子节点(通常是 TitleText RichText 节点)
LastChild最后一个直接子节点
AppendChildLast(node)追加子节点
GetChildNodes(Type)递归深度优先搜索
for child in title遍历直接子节点

继承自 Node

PropertiesProperties
ParentNode包含的 Page
Document根节点 Document

Properties

Accept(visitor)

title.Accept(visitor: DocumentVisitor) -> None

Properties 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 是子树中的真实子节点 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 用于没有标题元数据的页面。. TitleDateTitleTimeNone 当不存在时。始终进行检查::

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

另见

 中文