Cómo añadir un efecto de texto degradado en C#

¿Qué pasos hay que seguir para crear texto degradado?

Para especificar el efecto de degradado del texto, cree el objeto TextStyle y rellene la propiedad GradientEffect con un objeto Gradient. Finalmente, agrega nuevo texto con el estilo asignando el objeto TextStyle a la propiedad TextEffect. Este enfoque sigue el mismo patrón utilizado al crear presentaciones vacías con la biblioteca hermana de IronWord, IronPPT.

: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")

¿Qué opciones de degradado integradas hay disponibles?

IronWord proporciona varios degradados predeterminados accesibles a través de las propiedades estáticas de la clase Gradient, incluyendo DefaultGray y otras combinaciones de colores que se pueden aplicar al instante sin necesidad de configuración personalizada. Estos preajustes ofrecen opciones de estilo rápidas similares a las que se encuentran en el cuadro de diálogo de formato de texto de Microsoft Word. Los degradados incorporados funcionan con plantillas de documentos estándar y mantienen la legibilidad en distintos formatos de documento.

Cuando trabaje con efectos de degradado en entornos de producción, considere revisar las opciones de licencia para asegurarse de que su aplicación tiene la cobertura adecuada para sus escenarios de despliegue.

¿Cómo funcionan los topes de gradiente?

El efecto de degradado ofrece atributos ajustables para diversas necesidades de diseño. Consulta la siguiente lista para obtener descripciones detalladas de cada propiedad:

GradientStop

• Color: Obtiene o establece el color de esquema del tope de degradado. Los colores pueden especificarse utilizando las constantes de color predefinidas de IronWord o valores RGB personalizados.
• StopPoint: Obtiene o establece la posición de la parada del degradado. Los valores suelen oscilar entre 0 y 100, representando posiciones porcentuales a lo largo de la trayectoria del degradado.

Los puntos de detención de degradado son puntos dentro de un degradado donde se define un color específico. Las paradas múltiples crean transiciones suaves entre colores, y el espaciado entre paradas determina lo gradual o abrupto que parecen los cambios de color.

Gradient

• StopPoints: Obtiene o establece la lista de puntos de detención de degradado que definen el relleno degradado. Se requiere un mínimo de dos paradas para un degradado básico.
• LinearShadeScaled: Obtiene o establece un valor que indica si la sombra lineal está escalada. Cuando es verdadero, el degradado se ajusta para adaptarse a los límites del texto.
• LinearShadeAngle: Obtiene o establece el ángulo de la sombra lineal. Esta propiedad controla la dirección del flujo de gradiente a través del texto.

Para los equipos que planean ampliar sus capacidades de procesamiento de documentos, las opciones de actualización ofrecen vías flexibles para escalar su implementación a través de múltiples proyectos y desarrolladores.

¿Cómo puedo crear efectos de degradado personalizados?

La creación de efectos de degradado personalizados permite un estilo de texto único que se ajusta a los requisitos de la marca o el diseño. El siguiente ejemplo muestra cómo crear un degradado de dos colores con propiedades específicas de ángulo y escala. Para conocer las últimas funciones y mejoras relacionadas con los efectos de degradado, consulta el anuncio de cambios del producto.

: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")

¿Qué ángulos producen efectos diferentes?

LinearShadeAngle acepta valores de 0 a 360 grados, donde 0° crea un degradado horizontal de izquierda a derecha, 90° crea un degradado vertical de arriba abajo y 45° crea un efecto de degradado diagonal como se muestra en el ejemplo anterior. Las configuraciones angulares comunes incluyen:

• 0° (Horizontal de izquierda a derecha): Crea un degradado de lado a lado, ideal para encabezados modernos
• 90° (Vertical de arriba abajo): Produce un efecto de desvanecimiento de arriba hacia abajo
• 45° (Diagonal): Genera una transición de esquina a esquina
• 180° (Horizontal de derecha a izquierda): Invierte la dirección del gradiente horizontal estándar
• 270° (Vertical de abajo a arriba): Crea un efecto de gradiente ascendente

Al implementar efectos de degradado en varios documentos o plantillas, considere la posibilidad de licenciar extensiones para garantizar el acceso continuo a actualizaciones y asistencia.

Mejores prácticas para efectos de texto degradado

A la hora de aplicar efectos de degradado al texto en documentos profesionales, tenga en cuenta estas directrices:

1. Primero la legibilidad: Garantizar un contraste suficiente entre los colores degradados y el fondo del documento
2. Armonía cromática: Elija colores que complementen el esquema de diseño general de su documento
3. Sutilidad en documentos comerciales: Para los documentos formales, utilice degradados apagados en lugar de transiciones de color en negrita
4. Consideraciones de rendimiento: Los degradados complejos con muchas paradas pueden afectar a la velocidad de renderizado del documento
5. Compatibilidad multiplataforma: Comprueba el aspecto de los degradados en distintos visores de Word y exportaciones a PDF

Los efectos de degradado funcionan especialmente bien para elementos de documentos como títulos de capítulos, encabezados de sección y texto de llamada, donde el énfasis visual mejora la experiencia de navegación del lector.