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 הוא צומת ילד אמיתי ב‑ 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 ""

ראה גם

 עברית