Adicionar contorno de texto

VB C#

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

Imports IronWord
Imports IronWord.Models

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = TextOutlineEffect.DefaultEffect
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Hello World"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")

Install-Package IronWord

Adicionar contorno de texto

Adicionando efeitos de contorno de texto

Os efeitos de contorno de texto melhoram a visibilidade e o estilo do texto, desenhando uma borda ao redor de cada caractere. Esse efeito é particularmente útil para criar textos em negrito e chamativos ou para garantir a legibilidade quando o texto aparece sobre imagens ou fundos coloridos. O IronWord fornece a classe TextOutlineEffect com configurações predefinidas para rápida implementação.

Para aplicar um contorno de texto, crie um objeto TextStyle e configure sua propriedade TextEffect com TextOutlineEffect.DefaultEffect. Esta predefinição fornece uma configuração de contorno padrão que funciona bem na maioria dos cenários. Para contornos personalizados, os desenvolvedores podem especificar propriedades como largura do contorno, cor e estilo da linha para obter efeitos visuais específicos.

Após configurar o estilo do texto, crie um Run contendo o desejado TextContent e atribua o estilo configurado à propriedade Style do run. Use AddChild para adicionar o run estilizado a um parágrafo, então adicione o parágrafo ao documento. Essa abordagem estruturada garante a formatação adequada e mantém a integridade do documento.

Explicação do código

Aplicar um contorno ao texto é extremamente simples com o IronWord. Apesar de sua simplicidade, cada atributo do contorno do texto pode ser ajustado para atender a todas as necessidades. Uma vez que um documento Word é importado, o textStyle é configurado para incluir um efeito de contorno de texto atribuindo TextOutlineEffect.DefaultEffect à propriedade TextOutlineEffect de uma nova instância TextEffect.

Para aplicar esse efeito ao texto, um Paragraph é criado, então um objeto Run é criado contendo o desejado TextContent. O textStyle configurado é atribuído ao Run, aplicando o efeito de contorno de texto. O Run é adicionado ao Paragraph usando AddChild, e o Paragraph é adicionado ao documento. Isso segue a hierarquia do documento: Documento → Parágrafo → Execução → Conteúdo do Texto. Finalmente, o documento é exportado.

Saiba mais sobre Elementos de Documento com o IronWord.