RichText

RichText — Aspose.Note FOSS for Python API Reference

Клас: RichText

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

RichText представляє блок стилізованого тексту всередині an OutlineElement, TableCell, або Title. Він надає повний вміст у вигляді простого тексту через .Text та окремі сегменти форматування через .Runs.

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`Text`	`str`	Enumerations	Повний рядок простого тексту (усі фрагменти об’єднані)
`Runs`	`list[TextRun]`	Enumerations	Впорядкований список окремо відформатованих сегментів
`FontSize`	`float	None`	Enumerations
`Tags`	`list[NoteTag]`	Enumerations	Теги OneNote, прикріплені до цього текстового блоку

Успадковано від CompositeNode / Node

Enumerations	Enumerations
`ParentNode`	Вузол, що містить (OutlineElement, TableCell, Title)
`Document`	Кореневий документ

Enumerations

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

Enumerations VisitRichTextStart(rt) і VisitRichTextEnd(rt) на відвідувача.

TextRun

Кожен елемент RichText.Runs є TextRun:

Enumerations	Enumerations	Enumerations
`Text`	`str`	Текст сегмента
`Style`	`TextStyle`	Властивості форматування для цього сегмента
`Start`	`int	None`
`End`	`int	None`

TextStyle

TextRun.Style є TextStyle з наступними властивостями:

Enumerations	Enumerations	Enumerations
`Bold`	`bool`	Enumerations
`Italic`	`bool`	Enumerations
`Underline`	`bool`	Enumerations
`Strikethrough`	`bool`	Enumerations
`Superscript`	`bool`	Enumerations
`Subscript`	`bool`	Enumerations
`FontName`	`str	None`
`FontSize`	`float	None`
`FontColor`	`int	None`
`Highlight`	`int	None`
`Language`	`int	None`
`IsHyperlink`	`bool`	Чи є цей фрагмент гіперпосиланням
`HyperlinkAddress`	`str	None`

Приклади використання

Отримати весь простий текст

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 завжди є a str (ніколи None). Runs завжди є списком (може бути порожнім). FontSize, FontColor, Highlight, Language, HyperlinkAddress може бути None.

Див. також

Enumerations: предок RichText
TextRun: окремий форматований сегмент
TextStyle: властивості форматування
NoteTag: теги в тексті
Посібник розробника з видобутку тексту
Інструкція: Витягнути текст з OneNote (KB)
Блог: Витягнути текст з OneNote у Python