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
| Properties | Properties | Properties | Properties |
|---|---|---|---|
TitleText | `RichText | None` | Properties |
TitleDate | `RichText | None` | Properties |
TitleTime | `RichText | None` | Properties |
สืบทอดจาก CompositeNode
| คุณสมบัติ / วิธีการ | Properties |
|---|---|
FirstChild | โหนดลูกโดยตรงแรก (โดยทั่วไปคือ TitleText RichText โหนด) |
LastChild | โหนดลูกโดยตรงสุดท้าย |
AppendChildLast(node) | เพิ่มโหนดลูก |
GetChildNodes(Type) | การค้นหาแบบลึกแรกแบบเรียกซ้ำ |
for child in title | วนซ้ำลูกโดยตรง |
สืบทอดจาก Node
| Properties | Properties |
|---|---|
ParentNode | ส่วนที่บรรจุ Page |
Document | ราก Document |
Properties
Accept(visitor)
title.Accept(visitor: DocumentVisitor) -> NoneProperties 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