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

¿Qué efectos de sombra preestablecidos hay disponibles?

IronWord proporciona varios preajustes de sombra incorporados como OuterShadow1 hasta OuterShadow20 que ofrecen diferentes estilos visuales. Estos preajustes permiten una implementación rápida sin necesidad de configuración manual. Cada preajuste se ha diseñado cuidadosamente para que coincida con los casos de uso comunes en la creación de documentos profesionales:

• OuterShadow1-5: Sombras sutiles para el cuerpo del texto y los encabezados
• OuterShadow6-10: Sombras de intensidad media para títulos y énfasis
• OuterShadow11-15: Sombras en negrita para portadas y separadores de sección
• OuterShadow16-20: Efectos dramáticos para presentaciones y documentos creativos

Para estar al día de las nuevas adiciones y mejoras, consulte regularmente el changelog. El equipo de desarrollo perfecciona continuamente estos preajustes basándose en los comentarios de los usuarios y en las tendencias del sector.

¿Cuándo debo utilizar efectos de sombra preestablecidos o personalizados?

Utilice sombras preestablecidas para el formato estándar de los documentos y las implementaciones rápidas. Elige sombras personalizadas cuando necesites requisitos de marca específicos o efectos visuales únicos que los preajustes no ofrecen. Las sombras preestablecidas destacan en situaciones en las que la coherencia entre varios documentos es crucial, como plantillas corporativas o informes estandarizados.

Las sombras personalizadas resultan muy útiles cuando se trabaja con directrices de marca que especifican valores exactos de color, posicionamiento o efectos de desenfoque. Los equipos de marketing a menudo necesitan especificaciones precisas para mantener la identidad visual en todos los materiales. Además, las sombras personalizadas permiten crear efectos creativos como sombras de varias capas o sombras que complementan colores de fondo específicos.

¿Qué es el patrón básico de implementación?

Cree un WordDocument, configure TextStyle con ShadowEffect, aplique el estilo al texto y guarde el documento. El patrón debe ser coherente tanto si se utilizan configuraciones preestablecidas como personalizadas.

:path=/static-assets/word/content-code-examples/how-to/text-effect-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

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

// Export new Word document
doc.SaveAs("shadowEffect.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 {.ShadowEffect = Shadow.OuterShadow1}

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

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

¿Qué propiedades controlan el posicionamiento de las sombras?

• Alineación: Obtiene o establece la alineación de la sombra.
• Ángulo de Dirección: Obtiene o establece el ángulo de dirección del efecto de sombra. El ángulo de dirección se especifica en grados.
• Distancia Desde el Texto: Obtiene o establece la distancia del efecto de sombra desde el texto u objeto. La distancia se especifica en puntos (1/72 de pulgada).

Estas propiedades de posicionamiento se combinan para crear efectos de sombra realistas. La propiedad Alignment determina el punto de anclaje de la sombra con respecto al texto, mientras que DirectionAngle simula la dirección de la fuente de luz. DistanceFromText controla la elevación percibida del texto sobre la superficie de la página. La combinación de estas propiedades crea sombras que parecen proceder de fuentes de luz coherentes en todo el documento.

¿Qué propiedades afectan al aspecto de las sombras?

• Radio de Desenfoque: Obtiene o establece el radio de desenfoque del efecto de sombra. El radio de desenfoque se especifica en puntos (1/72 de pulgada).
• Color del Esquema: Obtiene o establece el color del esquema del efecto de sombra.

Las propiedades de apariencia afectan directamente a la calidad visual de sus sombras. BlurRadius crea bordes de sombra suaves o duros: los valores más bajos producen sombras nítidas adecuadas para documentación técnica, mientras que los valores más altos crean sombras difusas ideales para diseños creativos. SchemeColor permite ajustar las sombras a la paleta de colores del documento, manteniendo la coherencia visual en todo el contenido.

¿Cómo controlo el escalado y la inclinación de las sombras?

• Factor de Escala Horizontal: Obtiene o establece el factor de escala horizontal del efecto de sombra.
• Ángulo de Inclinación Horizontal: Obtiene o establece el ángulo de inclinación horizontal del efecto de sombra. El ángulo de inclinación se especifica en grados.
• Factor de Escala Vertical: Obtiene o establece el factor de escala vertical del efecto de sombra.
• Ángulo de Inclinación Vertical: Obtiene o establece el ángulo de inclinación vertical del efecto de sombra. El ángulo de inclinación se especifica en grados.

Las propiedades de escalado y sesgado permiten efectos de perspectiva que añaden dimensionalidad al texto. HorizontalScalingFactor y VerticalScalingFactor estiran o comprimen la sombra, creando efectos que simulan diferentes ángulos de visión. Los ángulos oblicuos permiten crear efectos de sombra tipo cursiva o simular sombras proyectadas sobre superficies inclinadas, lo que añade una sofisticada profundidad visual a los documentos.

¿Cuáles son los rangos de valores de propiedad comunes?

BlurRadius suele oscilar entre 0 y 10 puntos, DirectionAngle entre 0 y 360 grados, y los factores de escala utilizan valores porcentuales (100 = tamaño normal). DistanceFromText suele funcionar mejor entre 1 y 5 puntos para conseguir efectos sutiles.

La comprensión de estas gamas ayuda a conseguir resultados profesionales rápidamente. Para los documentos comerciales, los valores conservadores (BlurRadius: 2-4, DistanceFromText: 1-2) mantienen la legibilidad al tiempo que añaden interés visual. Las aplicaciones creativas pueden sobrepasar estos límites con efectos dramáticos (BlurRadius: 8-10, DistanceFromText: 4-6) para causar impacto. Recuerde que las capacidades de la impresora y la resolución de la pantalla afectan al aspecto de las sombras, así que pruebe sus documentos con los métodos de salida previstos.

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

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

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

// Add text with style
doc.AddText("Customized shadow").Style = textStyle;

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

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

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

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
	.ShadowEffect = New Shadow() With {
		.Alignment = RectangleAlignmentValues.BottomLeft,
		.BlurRadius = 5,
		.DirectionAngle = 45,
		.DistanceFromText = 3,
		.HorizontalScalingFactor = 100,
		.VerticalScalingFactor = 100,
		.HorizontalSkewAngle = 0,
		.SchemeColor = IronWord.Models.Color.Aqua,
		.VerticalSkewAngle = 0
	}
}

' Add text with style
doc.AddText("Customized shadow").Style = textStyle

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