Title — Aspose.Note FOSS for Python API Reference

คลาส: Title

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

Title ถือบล็อกหัวเรื่องของ a 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)

ใช้ visitor เพื่อรวบรวมข้อความหัวเรื่อง

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

ดูเพิ่มเติม

  • Properties: โหนดพาเรนท์; เปิดเผย page.Title
  • RichText: ชนิดของ TitleText, TitleDate, TitleTime
  • DocumentVisitor: VisitTitleStart / VisitTitleEnd
 ภาษาไทย