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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Text | str | Leitura/Gravação | O conteúdo de texto deste segmento. O padrão é "". |
Style | TextStyle | Leitura/Gravação | Propriedades de formatação para este segmento. Veja TextStyle. |
Start | `int | None` | ImageRenderOptions |
End | `int | None` | ImageRenderOptions |
Herda de Node
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
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
- RichText: nó pai que possui
TextRuns - TextStyle: propriedades de formatação para um
TextRun - ImageRenderOptions: classe base
- Guia do Desenvolvedor