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

همچنین ببینید

 فارسی