Cómo Añadir un Efecto de Contorno de Texto al Texto en C# | IronWord

Cómo agregar un efecto de contorno de texto en C

This article was translated from English: Does it need improvement?
Translated
View the article in English

Un efecto de contorno de texto añade un borde visible alrededor de los caracteres del texto, creando un contorno definido que mejora la legibilidad o el impacto visual. Este efecto se puede personalizar en términos de color, grosor y estilo para adaptarse a las preferencias de diseño. Es comúnmente utilizado en gráficos, tipografía y diseño digital para hacer que el texto destaque contra el fondo o para crear una apariencia estilizada.

Inicio rápido: Aplicar un efecto de contorno de texto predeterminado instantáneamente

Con solo una línea, crea un TextStyle que aplica un contorno de texto predefinido a través de TextOutlineEffect.DefaultEffect. Es una forma rápida de permitir a los desarrolladores usar IronWord para hacer que el texto destaque sin configuraciones complejas.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronWord con el gestor de paquetes NuGet

    PM > Install-Package IronWord

  2. Copie y ejecute este fragmento de código.

    new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { TextOutlineEffect = IronWord.Models.TextOutlineEffect.DefaultEffect } }
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronWord en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Añadir efecto de contorno 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.

: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");
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 {.TextOutlineEffect = TextOutlineEffect.DefaultEffect}

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

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")
$vbLabelText   $csharpLabel
Añadir efecto de contorno de texto

Propiedades del efecto de contorno de texto

El efecto de contorno de texto ofrece una variedad de propiedades personalizables para adaptarse a cualquier necesidad de diseño. A continuación se presentan las propiedades junto con sus descripciones:

  • PenAlignment: Obtiene o establece la alineación del bolígrafo usado para el efecto de contorno.
  • LineCapType: Obtiene o establece el tipo de terminación de línea usada para el efecto de contorno.
  • LineWidth: Obtiene o establece el ancho de línea del efecto de contorno. Nota: El ancho está especificado en puntos (1/72 pulgada).
  • CompoundLineType: Obtiene o establece el tipo de línea compuesta usada para el efecto de contorno.
  • LineJoin: Obtiene o establece el estilo de unión de trazo usado para el efecto de contorno.
  • Color: Obtiene o establece el color de relleno sólido para el efecto de contorno.
  • PresetLineDash: Obtiene o establece el estilo de guion predefinido para el efecto de contorno.
: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");
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 {
	.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
	}
}

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

' Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx")
$vbLabelText   $csharpLabel
Efecto de contorno de texto personalizado

Preguntas Frecuentes

¿Qué es un efecto de contorno de texto en un documento de Word?

Un efecto de contorno de texto en un documento de Word agrega un borde visible alrededor de los caracteres de texto, mejorando su legibilidad e impacto visual. Este efecto es personalizable en términos de color, grosor y estilo para adaptarse mejor a las preferencias de diseño.

¿Cómo puedo aplicar un efecto de contorno de texto en C#?

En C#, puedes aplicar un efecto de contorno de texto usando la clase TextOutlineEffect en IronWord. Puedes configurar sus propiedades como color, ancho de línea y estilo para personalizar el efecto para tu texto.

¿Cuáles son los pasos para agregar un efecto de contorno de texto usando IronWord?

Los pasos incluyen descargar la biblioteca IronWord, aplicar el efecto de texto a texto nuevo o existente, configurar las propiedades de TextOutlineEffect y exportar el documento editado como un nuevo archivo.

¿Puedo personalizar las propiedades de un efecto de contorno de texto en C#?

Sí, puedes personalizar el efecto de contorno de texto ajustando propiedades como PenAlignment, LineCapType, LineWidth, CompoundLineType, LineJoin, Color y PresetLineDash usando IronWord.

¿Cuál es la unidad de medida para el ancho de línea en un efecto de contorno de texto?

El ancho de línea de un efecto de contorno de texto se mide en puntos, donde un punto equivale a 1/72 de una pulgada.

¿Cómo exporto un documento de Word después de aplicar un efecto de contorno de texto?

Después de aplicar un efecto de contorno de texto en IronWord, puedes exportar el documento de Word editado usando las funciones de exportación de la biblioteca para guardar tus cambios como un nuevo archivo.

¿Cuál es el propósito de usar efectos de contorno de texto en el diseño?

Los efectos de contorno de texto se usan para hacer que el texto sobresalga sobre los fondos o para crear una apariencia estilizada, mejorando la legibilidad y el impacto visual en el diseño digital.

¿Cómo defino un estilo de texto con un efecto de contorno de texto en C#?

Puedes definir un estilo de texto creando un objeto TextStyle y llenando su propiedad TextOutlineEffect con un objeto TextOutlineEffect. Asigna este estilo a tu texto a través de la propiedad TextEffect.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 27,129 | Version: 2025.11 recién lanzado