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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
TitleText | `RichText | None` | ImageRenderOptions |
TitleDate | `RichText | None` | ImageRenderOptions |
TitleTime | `RichText | None` | ImageRenderOptions |
ירש מ-CompositeNode
| מאפיין / שיטה | ImageRenderOptions |
|---|---|
FirstChild | הצומת הישיר הראשון (בדרך כלל TitleText RichText צומת) |
LastChild | הצומת הישיר האחרון |
AppendChildLast(node) | הוסף צומת ילד |
GetChildNodes(Type) | חיפוש עומק ראשון רקורסיבי |
for child in title | חזור על הילדים הישירים |
יורש מ-Node
| ImageRenderOptions | ImageRenderOptions |
|---|---|
ParentNode | הכולל Page |
Document | השורש Document |
ImageRenderOptions
Accept(visitor)
title.Accept(visitor: DocumentVisitor) -> NoneImageRenderOptions 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 לדפים ללא מטא‑נתוני כותרת. TitleDate ו TitleTime הם None כאשר אינם קיימים. תמיד לשמור על:
text = page.Title.TitleText.Text if page.Title and page.Title.TitleText else ""ראה גם
- ImageRenderOptions: צומת אב; חושף
page.Title - RichText: סוג של TitleText, TitleDate, TitleTime
- DocumentVisitor:
VisitTitleStart/VisitTitleEnd