1. IronWord
  2. Guías
  3. Efecto degradado en el texto
Cómo Configurar la Impresión en PDF Usando C# | IronPrint

Cómo agregar un efecto de texto degradado en C

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Un efecto degradado en el texto implica aplicar una transición suave de colores a través de los caracteres o el fondo del texto, creando una mezcla de un color a otro o múltiples colores. Este efecto agrega profundidad, interés visual y una apariencia dinámica al texto, haciéndolo destacar y mejorando su apariencia estética. Los efectos de degradado pueden ser lineales (colores que transicionan en línea recta) o radiales (colores que transicionan desde un punto central hacia afuera).

Inicio rápido: Agregar un efecto degradado al texto con IronWord

Aquí hay un ejemplo simple que muestra cómo usar IronWord para aplicar un efecto degradado incorporado al texto en solo unas pocas líneas, perfecto si deseas empezar rápidamente y ver resultados visuales al instante.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronWord con el gestor de paquetes NuGet

    PM > Install-Package IronWord

  2. Copie y ejecute este fragmento de código.

    var doc = new IronWord.WordDocument();
doc.AddText("Test").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ GradientEffect = IronWord.Models.Gradient.DefaultGray } };
doc.SaveAs("out.docx");

  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronWord en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Flujo de trabajo mínimo (5 pasos)

  1. Descargue una biblioteca de C# que permite agregar degradados al texto.
  2. Aplicar el efecto de texto a texto recién creado o existente.
  3. Utilice un efecto de degradado preestablecido mediante la instancia con nombre estático de la clase Gradient .
  4. Configure las propiedades de GradientEffect para personalizar el contorno del texto.
  5. Exportar el documento de Word editado como un archivo nuevo.

Añadir efecto degradado

Para especificar el efecto degradado para el texto, crea el objeto TextStyle y llena la propiedad GradientEffect con un objeto Gradient. Finalmente, agrega texto nuevo con el estilo asignando el objeto TextStyle a la propiedad TextEffect.

:path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-effect.cs
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,
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("gradientEffect.docx");
Imports IronWord
Imports IronWord.Models

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

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {.GradientEffect = Gradient.DefaultGray}

' Add text with style
doc.AddText("Hello World").Style = textStyle

' Export new Word document
doc.SaveAs("gradientEffect.docx")
$vbLabelText   $csharpLabel
Añadir efecto degradado

Propiedades del efecto degradado

El efecto degradado ofrece una gama de atributos ajustables para satisfacer diversos requisitos de diseño. Consulta la siguiente lista para obtener descripciones detalladas de cada propiedad:

GradientStop

  • Color: Obtiene o establece el color del esquema del punto de degradado.
  • StopPoint: Obtiene o establece la posición del punto de degradado.

Los puntos de detención de degradado son puntos dentro de un degradado donde se define un color específico.

Gradient

  • StopPoints: Obtiene o establece la lista de puntos de detención de degradado que definen el relleno degradado.
  • LinearShadeScaled: Obtiene o establece un valor que indica si la sombra lineal está escalada.
  • LinearShadeAngle: Obtiene o establece el ángulo de la sombra lineal.
:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-gradient-effect.cs
using IronWord;
using IronWord.Models;
using System.Collections.Generic;

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

// Create gradient stops
GradientStop firstGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.Aqua,
    StopPoint = 1
};
GradientStop secondGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.OrangeRed,
    StopPoint = 10
};

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    GradientEffect = new Gradient()
    {
        StopPoints = new List<GradientStop> { firstGradientStop, secondGradientStop },
        LinearShadeAngle = 45,
        LinearShadeScaled = true,
    }
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedGradientEffect.docx");
Imports IronWord
Imports IronWord.Models
Imports System.Collections.Generic

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

' Create gradient stops
Private firstGradientStop As New GradientStop() With {
	.Color = IronWord.Models.Color.Aqua,
	.StopPoint = 1
}
Private secondGradientStop As New GradientStop() With {
	.Color = IronWord.Models.Color.OrangeRed,
	.StopPoint = 10
}

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
	.GradientEffect = New Gradient() With {
		.StopPoints = New List(Of GradientStop) From {firstGradientStop, secondGradientStop},
		.LinearShadeAngle = 45, .LinearShadeScaled = True
	}
}

' Add text with style
doc.AddText("Hello World").Style = textStyle

' Export new Word document
doc.SaveAs("customizedGradientEffect.docx")
$vbLabelText   $csharpLabel
Efecto de degradado personalizado

Preguntas Frecuentes

¿Cómo puedo añadir un efecto degradado al texto en un documento de Word usando C#?

Puedes añadir un efecto degradado al texto en un documento de Word utilizando la biblioteca C# de IronWord. Primero, descarga la biblioteca, luego aplica el efecto de texto a texto nuevo o existente. Usa un efecto degradado predefinido a través de la instancia estática nombrada de la clase Gradient y personalízalo configurando las propiedades de GradientEffect.

¿Cuáles son los pasos para aplicar un efecto degradado usando IronWord?

Para aplicar un efecto degradado usando IronWord, sigue estos pasos: descarga la biblioteca C#, aplica el degradado al texto, utiliza un efecto degradado predefinido de la clase Gradient, configura las propiedades de GradientEffect y finalmente, exporta el documento editado.

¿Cómo crear un objeto TextStyle con un efecto degradado en IronWord?

En IronWord, crea un objeto TextStyle y rellena la propiedad GradientEffect con un objeto Gradient. Asigna este TextStyle a la propiedad TextEffect para aplicarlo a tu texto.

¿Cuál es el propósito de los puntos de parada de gradiente en IronWord?

Los puntos de parada de gradiente en IronWord son puntos dentro de un degradado donde se define un color específico. Se controlan utilizando la clase GradientStop, que incluye propiedades como Color para el color del esquema y StopPoint para la posición del punto de parada del gradiente.

¿Se pueden personalizar los puntos de gradiente en IronWord?

Sí, puedes personalizar los puntos de parada de gradiente en IronWord añadiendo objetos GradientStop con colores y posiciones específicos a la lista StopPoints de un objeto Gradient, permitiendo efectos de degradado personalizados.

¿Cuáles son las propiedades clave de la clase Gradient en IronWord?

La clase Gradient en IronWord incluye propiedades clave como StopPoints, que definen los puntos de parada de gradiente, LinearShadeScaled, que indica si la sombra lineal está escalada, y LinearShadeAngle, que establece el ángulo de la sombra lineal.

¿Cómo exportar un documento de Word después de añadir un efecto degradado usando IronWord?

Después de añadir un efecto degradado al texto usando IronWord, puedes exportar el documento de Word editado guardándolo como un nuevo archivo en tu formato deseado con los efectos degradados aplicados.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 27,129 | Version: 2025.11 recién lanzado