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

¿Por qué debería utilizar TextOutlineEffect para el estilo de texto?

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

La clase TextOutlineEffect proporciona una API completa para controlar todos los aspectos de los contornos de texto. A diferencia de las opciones básicas de formato de texto, ofrece un control granular sobre las propiedades del contorno, como el ancho de línea, el color, la alineación de la pluma y los patrones de guiones. Este nivel de control es esencial a la hora de crear documentos profesionales que deban cumplir directrices específicas de marca o requisitos de accesibilidad.

En el caso de las aplicaciones empresariales, los contornos de texto pueden mejorar significativamente la legibilidad de los documentos cuando se imprimen en distintos tipos de papel o se visualizan en diferentes dispositivos. El contorno crea una zona de amortiguación alrededor de cada carácter, lo que garantiza que el texto siga siendo legible incluso sobre fondos recargados o situaciones de bajo contraste.

¿Cuál es el patrón de código básico para añadir esquemas?

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

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

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

Este patrón básico muestra el enfoque fundamental para aplicar contornos de texto. El código crea un nuevo documento, define un estilo de texto con el efecto de contorno predeterminado, lo aplica al texto y guarda el resultado. El EfectoPorDefecto proporciona un contorno equilibrado que funciona bien en la mayoría de los casos, con una anchura sutil y un color complementario que realza el texto en lugar de sobrecargarlo.

¿Qué propiedades controlan el aspecto del esquema?

El efecto de contorno de texto ofrece una variedad de propiedades personalizables para adaptarse a cualquier necesidad de diseño. Comprender estas propiedades le permitirá crear esquemas que se ajusten perfectamente a los requisitos visuales del documento y a las directrices de la marca. A continuación se presentan las propiedades junto con sus descripciones:

Cada propiedad tiene una función específica en la creación de contornos de texto de aspecto profesional. Por ejemplo, LineWidth afecta directamente a la prominencia visual: los contornos más finos (0,1-0,3 puntos) crean un énfasis sutil, mientras que los contornos más gruesos (1,0-2,0 puntos) hacen declaraciones en negrita. La propiedad Color es crucial para mantener la coherencia de la marca y garantizar un contraste adecuado para la accesibilidad.

¿Cómo se aplican las propiedades de contorno personalizadas?

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-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()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

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

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

Este ejemplo avanzado muestra toda la potencia de la configuración de esquemas personalizados. El código crea un contorno rojo distintivo con un estilo de línea doble, demostrando cómo múltiples propiedades trabajan juntas para lograr efectos visuales específicos. Los remates de línea redondeados y las uniones en bisel crean contornos suaves y de aspecto profesional que funcionan bien para encabezados y títulos.

Al implementar esquemas personalizados en aplicaciones de producción, considere la posibilidad de crear plantillas de estilo reutilizables. Definir configuraciones de esquema estándar para distintos elementos del documento (encabezados, subencabezados, texto de énfasis) y almacenarlas como constantes o ajustes de configuración. Este enfoque garantiza la coherencia en todo el proceso de generación de documentos y simplifica el mantenimiento cuando cambian las directrices de la marca.

Para obtener resultados óptimos, pruebe los efectos del esquema en diferentes formatos de salida y condiciones de visualización. Lo que se ve bien en pantalla puede necesitar ajustes para su impresión. Tenga en cuenta factores como la resolución de la impresora, el color del papel y la distancia de visualización a la hora de seleccionar el ancho y el color de los contornos. La flexibilidad de la clase TextOutlineEffect de IronWord permite ajustar estos parámetros mediante programación en función de los requisitos de salida.