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

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

Para aplicar un efecto de contorno de texto, cree un TextStyle y llene su propiedad TextEffect con un TextOutlineEffect. Luego, cree un Paragraph, seguido de un Run que contenga TextContent. Asigne el TextStyle al Run (no al TextContent), luego utilice AddChild para añadir el Run al Paragraph. Esto sigue la jerarquía del documento: Documento → Párrafo → Ejecutar → Contenido de texto.

La clase TextOutlineEffect proporciona una API integral para controlar todos los aspectos de sus 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,
};

// 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("textOutlineEffect.docx");

Imports IronWord
Imports IronWord.Models

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

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = TextOutlineEffect.DefaultEffect
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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("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 DefaultEffect ofrece un contorno equilibrado que funciona bien para la mayoría de los escenarios, con un ancho sutil y un color complementario que realza, en lugar de abrumar, el texto.

¿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 impacta directamente en la prominencia visual: los contornos más delgados (0.1-0.3 puntos) crean un énfasis sutil, mientras que los contornos más gruesos (1.0-2.0 puntos) hacen declaraciones audaces. La propiedad Color es crucial para mantener la consistencia de la marca y asegurar 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
    },
};

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

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

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

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

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

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

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

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = New TextOutlineEffect() With {
        .Color = IronWord.Models.Color.Red,
        .CompoundLineType = CompoundLineValues.Double,
        .LineCapType = LineCapValues.Round,
        .LineJoin = StrokeJoinStyleValues.Bevel,
        .LineWidth = 0.3,
        .PenAlignment = PenAlignmentValues.Center,
        .presetLineDash = PresetLineDashValues.Solid
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized text outline"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' 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 le permite ajustar finamente estos parámetros de forma programática según los requisitos de salida.