Adicionar efeito gradiente
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()
{
    GradientEffect = Gradient.DefaultGray,
};

// 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("gradientEffect.docx");
NuGet Download
PM > Install-Package IronWord
Adicionar efeito gradiente

Adicionar efeito gradiente

Aplicando efeitos de gradiente ao texto

O efeito de gradiente no IronWord permite que o texto exiba transições de cores, criando designs visualmente atraentes. O IronWord fornece opções de gradiente predefinidas através da classe Gradient, como Gradient.DefaultGray, que podem ser atribuídas diretamente à propriedade GradientEffect de um(a) TextEffect.

Para aplicar um gradiente, crie um objeto TextStyle e configure sua propriedade TextEffect com um GradientEffect. O gradiente pode ser definido usando instâncias estáticas predefinidas da classe Gradient, que oferecem esquemas de cores e transições comumente usados. Esses presets simplificam o processo de adicionar gradientes com aparência profissional sem a necessidade de configurar manualmente as paradas de cor.

Uma vez que o estilo é configurado, crie um Run contendo TextContent e atribua o estilo à propriedade Style do run. Adicione o run a um parágrafo usando AddChild, então insira o parágrafo no documento. Essa abordagem estruturada garante que o efeito de gradiente seja aplicado corretamente e preservado no documento de saída.

Explicação do código

O código acima demonstra como aplicar um efeito de gradiente ao texto. Primeiro, ele cria um novo documento do Word. Em seguida, cria um objeto TextStyle e o configura para usar um efeito de gradiente atribuindo o preset Gradient.DefaultGray à propriedade GradientEffect.

Para adicionar o texto estilizado, um Paragraph é criado, então um objeto Run é criado contendo TextContent com "Olá Mundo". O TextStyle configurado é atribuído ao Run, aplicando o efeito de gradiente. 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 novo documento do Word é exportado.

Para mais exemplos e demonstrações, acesse o seguinte artigo: Como adicionar efeito de gradiente ao texto .

Explore mais tutoriais sobre elementos de documentos do Word aqui.
Ver no GitHub

Pronto para começar?

Nuget Downloads 61,140Versão:2026.11recém-lançado

Download gratuito do NuGet
Total de downloads: 61,140