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

¿Qué efectos de sombra preestablecidos hay disponibles?

IronWord proporciona varios ajustes preestablecidos de sombras integrados como OuterShadow1 a 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 a su 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,
};

// 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("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 en relación con el 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 sombras 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 le permite hacer coincidir las sombras con la paleta de colores de su documento, manteniendo la consistencia visual en todo su 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 normalmente varía de 0 a 10 puntos, DirectionAngle de 0 a 360 grados, y los factores de escala utilizan valores porcentuales (100 = tamaño normal). DistanceFromText generalmente funciona mejor entre 1 y 5 puntos para lograr efectos sutiles.

La comprensión de estas gamas ayuda a conseguir resultados profesionales rápidamente. Para documentos comerciales, los valores conservadores (BlurRadius: 2-4, DistanceFromText: 1-2) mantienen la legibilidad y añaden interés visual. Las aplicaciones creativas pueden ampliar estos límites con efectos impactantes (BlurRadius: 8-10, DistanceFromText: 4-6). 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,
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized shadow"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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