Notes
Python
RichText

RichText — Aspose.Note FOSS for Python API Reference

کلاس: RichText

ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import RichText ImageRenderOptions: CompositeNode

RichText نمایش یک بلوک متن قالب‌بندی‌شده در یک OutlineElement, TableCell, یا Title. این محتوا را به صورت متن ساده کامل از طریق .Text و بخش‌های قالب‌بندی فردی از طریق .Runs.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
TextstrImageRenderOptionsرشته متن ساده کامل (تمام بخش‌ها به‌هم‌پیوسته)
Runslist[TextRun]ImageRenderOptionsفهرست مرتب بخش‌های قالب‌بندی‌شده به‌صورت فردی
FontSize`floatNone`ImageRenderOptions
Tagslist[NoteTag]ImageRenderOptionsبرچسب‌های OneNote پیوست‌شده به این بلوک متن

ارث‌بری شده از CompositeNode / Node

ImageRenderOptionsImageRenderOptions
ParentNodeگره حاوی (OutlineElement, TableCell, Title)
Documentسند ریشه

ImageRenderOptions

ImageRenderOptions 

rt.Append(text: str, style: TextStyle | None = None) -> RichText

یک بخش متن جدید با سبک اختیاری اضافه می‌کند. بازمی‌گرداند self برای زنجیره‌سازی. در حافظه اجرا می‌شود؛ تغییرات نمی‌توانند به .one.

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
first_rt = doc.GetChildNodes(RichText)[0]
first_rt.Append(" [reviewed]")

Replace(old_value, new_value) 

rt.Replace(old_value: str, new_value: str) -> None

جایگزین تمام رخدادهای old_value با new_value در تمام بخش‌ها. در حافظه اجرا می‌شود.

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    rt.Replace("TODO", "DONE")

Accept(visitor) 

rt.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitRichTextStart(rt) و VisitRichTextEnd(rt) روی بازدیدکننده.

TextRun

هر عنصر از RichText.Runs یک TextRun:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
Textstrمتن بخش
StyleTextStyleویژگی‌های قالب‌بندی برای این بخش
Start`intNone`
End`intNone`

TextStyle

TextRun.Style یک TextStyle با ویژگی‌های زیر:

ImageRenderOptionsImageRenderOptionsImageRenderOptions
BoldboolImageRenderOptions
ItalicboolImageRenderOptions
UnderlineboolImageRenderOptions
StrikethroughboolImageRenderOptions
SuperscriptboolImageRenderOptions
SubscriptboolImageRenderOptions
FontName`strNone`
FontSize`floatNone`
FontColor`intNone`
Highlight`intNone`
Language`intNone`
IsHyperlinkboolآیا این بخش یک پیوند است
HyperlinkAddress`strNone`

مثال‌های استفاده

دریافت تمام متن ساده 

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    if rt.Text:
        print(rt.Text)

بازرسی تمام بخش‌ها با قالب‌بندی 

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    for run in rt.TextRuns:
        s = run.Style
        attrs = [a for a, v in [
            ("bold", s.IsBold), ("italic", s.IsItalic),
            ("underline", s.IsUnderline), ("strike", s.IsStrikethrough),
        ] if v]
        label = ", ".join(attrs) or "plain"
        print(f"  [{label}] {run.Text!r}")

استخراج پیوندهای ابرمتنی 

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    for run in rt.TextRuns:
        if run.Style.IsHyperlink and run.Style.HyperlinkAddress:
            print(f"  {run.Text!r} -> {run.Style.HyperlinkAddress}")

یافتن تمام متن‌های بولد 

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
bold_segments = [
    run.Text for rt in doc.GetChildNodes(RichText)
    for run in rt.TextRuns
    if run.Style.IsBold and run.Text.strip()
]
print(bold_segments)

خواندن برچسب‌ها 

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    for tag in rt.Tags:
        print(f"Tag: {tag.label!r}  on text: {rt.Text.strip()!r}")

ایمنی در برابر None

Text همیشه یک str (هرگز None). Runs همیشه یک لیست است (ممکن است خالی باشد). FontSize, FontColor, Highlight, Language, HyperlinkAddress می‌تواند باشد None.

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

 فارسی