TextRun — Aspose.Note FOSS for Python API Reference

Класс: TextRun

ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import TextRun ImageRenderOptions: Node

TextRun представляет собой один непрерывный сегмент текста, который имеет одинаковое форматирование внутри a RichText блок. A RichText.TextRuns список содержит один или более TextRun объектов; каждый имеет своё Style (TextStyle). Это самая мелкая единица отформатированного текста в модели документа.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
TextstrRead/WriteТекстовое содержимое этого сегмента. По умолчанию "".
StyleTextStyleRead/WriteСвойства форматирования для этого сегмента. См. TextStyle.
Start`intNone`ImageRenderOptions
End`intNone`ImageRenderOptions

Наследовано от Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`

Связь с RichText

ImageRenderOptions RichText узел владеет списком TextRun объектов через RichText.TextRuns. Конкатенирование run.Text для всех запусков дает полный RichText.Text:

RichText.Text == "".join(run.Text for run in RichText.TextRuns)

Каждый запуск несёт независимый Style, поэтому один абзац может содержать смешанные bold, italic, hyperlink или сегменты разных цветов.


Пример использования

Просмотреть все TextRun в документе

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 = []
        if s.Bold:        attrs.append("bold")
        if s.Italic:      attrs.append("italic")
        if s.Underline:   attrs.append("underline")
        if s.IsHyperlink: attrs.append(f"link={s.HyperlinkAddress!r}")
        label = ", ".join(attrs) or "plain"
        print(f"[{label}] {run.Text!r}")

Найти все гиперссылочные run

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

Безопасность при None

Text всегда является str (никогда None; по умолчанию ""). Start и End может быть None для запусков, созданных программно, до того как они будут присоединены к RichText. Style всегда присутствует.


См. также

 Русский