Adicionar efeito gradiente

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()
{
    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");

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 {
    .GradientEffect = Gradient.DefaultGray
}

' 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("gradientEffect.docx")

Install-Package IronWord

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.