TextRun — Aspose.Note FOSS for Python API Reference

Classe: TextRun

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

TextRun representa um único segmento contíguo de texto que compartilha formatação uniforme dentro de um RichText bloco. Um RichText.TextRuns lista contém um ou mais TextRun objetos; cada um tem seu próprio Style (TextStyle). Esta é a unidade mais granular de texto formatado no modelo de documento.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
TextstrLeitura/GravaçãoO conteúdo de texto deste segmento. O padrão é "".
StyleTextStyleLeitura/GravaçãoPropriedades de formatação para este segmento. Veja TextStyle.
Start`intNone`ImageRenderOptions
End`intNone`ImageRenderOptions

Herda de Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ParentNode`NodeNone`
Document`DocumentNone`

Relacionamento com RichText

ImageRenderOptions RichText nó possui uma lista de TextRun objetos via RichText.TextRuns. Concatenando run.Text para todas as execuções produz o completo RichText.Text:

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

Cada execução possui um independente Style, então um único parágrafo pode conter segmentos mistos em negrito, itálico, hyperlink, ou de cores diferentes.


Exemplo de Uso

Inspecionar todas as execuções em um documento

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

Encontrar todas as execuções de hyperlink

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

Segurança contra None

Text é sempre um str (nunca None; padrão é ""). Start e End pode ser None para execuções criadas programaticamente antes de serem anexadas a um RichText. Style está sempre presente.


Veja Também

 Português