RichText — Aspose.Note FOSS for Python API Reference

Classe : RichText

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

RichText représente un bloc de texte stylisé à l’intérieur d’un OutlineElement, TableCell, ou Title. Il expose le contenu texte brut complet via .Text et les segments de formatage individuels via .TextRuns.


Examples

ExamplesExamplesExamplesExamples
TextstrExamplesChaîne texte brut complète (toutes les séquences concaténées)
Runslist[TextRun]ExamplesListe ordonnée de segments formatés individuellement
FontSize`floatNone`Examples
Tagslist[NoteTag]ExamplesBalises OneNote attachées à ce bloc de texte

Hérité de CompositeNode / Node

ExamplesExamples
ParentNodeNœud contenant (OutlineElement, TableCell, Title)
DocumentDocument racine

Examples

Examples

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

Ajoute une nouvelle séquence de texte avec un style optionnel. Retourne self pour chaîner. Fonctionne en mémoire ; les modifications ne peuvent pas être enregistrées de nouveau dans .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

Remplace toutes les occurrences de old_value par new_value sur toutes les exécutions. Fonctionne en mémoire.

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

Examples VisitRichTextStart(rt) et VisitRichTextEnd(rt) sur le visiteur.


TextRun

Chaque élément de RichText.Runs est un TextRun:

ExamplesExamplesExamples
TextstrTexte du segment
StyleTextStylePropriétés de formatage pour ce segment
Start`intNone`
End`intNone`

TextStyle

TextRun.Style est un TextStyle avec les propriétés suivantes :

ExamplesExamplesExamples
BoldboolExamples
ItalicboolExamples
UnderlineboolExamples
StrikethroughboolExamples
SuperscriptboolExamples
SubscriptboolExamples
FontName`strNone`
FontSize`floatNone`
FontColor`intNone`
Highlight`intNone`
Language`intNone`
IsHyperlinkboolIndique si cette séquence est un hyperlien
HyperlinkAddress`strNone`

Exemples d’utilisation

Obtenir tout le texte brut

from aspose.note import Document, RichText

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

Inspecter toutes les séquences avec formatage

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

Extraire les hyperliens

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

Trouver tout le texte en gras

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)

Lire les balises

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

Sécurité None

Text est toujours un str (jamais None). Runs est toujours une liste (peut être vide). FontSize, FontColor, Highlight, Language, HyperlinkAddress peut être None.


Voir aussi

 Français