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