RichText

RichText — Aspose.Note FOSS for Python API Reference

Klasa: RichText

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

RichText reprezentuje blok stylowanego tekstu w OutlineElement, TableCell, lub Title. Udostępnia pełną zawartość tekstu zwykłego poprzez .Text oraz poszczególne segmenty formatowania poprzez .Runs.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Text`	`str`	ImageRenderOptions	Pełny ciąg tekstu zwykłego (wszystkie fragmenty połączone)
`Runs`	`list[TextRun]`	ImageRenderOptions	Uporządkowana lista indywidualnie sformatowanych segmentów
`FontSize`	`float	None`	ImageRenderOptions
`Tags`	`list[NoteTag]`	ImageRenderOptions	Tagi OneNote dołączone do tego bloku tekstu

Dziedziczone z CompositeNode / Node

ImageRenderOptions	ImageRenderOptions
`ParentNode`	Węzeł zawierający (OutlineElement, TableCell, Title)
`Document`	Dokument główny

ImageRenderOptions

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

Dodaje nowy fragment tekstu z opcjonalnym stylem. Zwraca self do łańcuchowania. Działa w pamięci; zmiany nie mogą być zapisane z powrotem do .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

Zastępuje wszystkie wystąpienia old_value przez new_value we wszystkich uruchomieniach. Działa w pamięci.

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) i VisitRichTextEnd(rt) na odwiedzającym.

TextRun

Każdy element RichText.Runs jest TextRun:

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Text`	`str`	Tekst segmentu
`Style`	`TextStyle`	Właściwości formatowania tego segmentu
`Start`	`int	None`
`End`	`int	None`

TextStyle

TextRun.Style jest TextStyle z następującymi właściwościami:

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Bold`	`bool`	ImageRenderOptions
`Italic`	`bool`	ImageRenderOptions
`Underline`	`bool`	ImageRenderOptions
`Strikethrough`	`bool`	ImageRenderOptions
`Superscript`	`bool`	ImageRenderOptions
`Subscript`	`bool`	ImageRenderOptions
`FontName`	`str	None`
`FontSize`	`float	None`
`FontColor`	`int	None`
`Highlight`	`int	None`
`Language`	`int	None`
`IsHyperlink`	`bool`	Czy ten fragment jest hiperłączem
`HyperlinkAddress`	`str	None`

Przykłady użycia

Pobierz cały zwykły tekst

from aspose.note import Document, RichText

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

Sprawdź wszystkie fragmenty wraz z formatowaniem

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

Wyodrębnij hiperłącza

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

Znajdź cały pogrubiony tekst

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)

Odczytaj znaczniki

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

Bezpieczeństwo przy None

Text zawsze jest a str (nigdy None). Runs zawsze jest listą (może być pusta). FontSize, FontColor, Highlight, Language, HyperlinkAddress może być None.

Zobacz także

ImageRenderOptions: przodek RichText
TextRun: indywidualny sformatowany segment
TextStyle: właściwości formatowania
NoteTag: tagi w tekście
Przewodnik dewelopera: ekstrakcja tekstu
Instrukcja: wyodrębnianie tekstu z OneNote (KB)
Blog: wyodrębnianie tekstu z OneNote w Python