Añadir estilo a texto

VB C#

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

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
	FontSize = 72,
	TextFont = new Font()
	{
		FontFamily = "Caveat"
	},
	Color = IronWord.Models.Color.Red,
	IsBold = true,
	IsItalic = true,
	Underline = new Underline(),
	Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

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

' Load docx
Dim doc As New WordDocument("document.docx")

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = IronWord.Models.Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")

Install-Package IronWord

Añadir estilo a texto

La función "Agregar texto de estilo" en IronWord permite a los desarrolladores aplicar varias opciones de estilo de texto al agregar contenido a un documento DOCX. Ofrece control detallado sobre la apariencia del texto, como especificar la familia de fuentes, tamaño, color y atributos de estilo como bold, italic, underline y strike-through. Al crear un objeto Run que contiene TextContent y asignar un TextStyle al Run, los desarrolladores pueden personalizar la presentación de elementos de texto individuales dentro de un documento, asegurando una apariencia y sensación personalizadas.

Esta función es útil para generar documentos con formato profesional de manera dinámica, como informes o cartas, donde secciones específicas requieren estilos distintos. La clase TextStyle permite una fácil manipulación de estos atributos, permitiendo tanto estilos simples como complejos dentro del mismo documento.

Puntos clave

Creación de una ejecución con estilo :
- Se crea un objeto Run que contiene TextContent con el texto deseado.
- A la propiedad Style del Run se le asigna un objeto TextStyle para aplicar formato. FontSize
Configuración de TextStyle :
- TextStyle: Establecido a nivel de TextStyle (no dentro de Font) para especificar el tamaño del texto.
- TextFont: Contiene propiedades de fuente incluyendo fontFamily para la selección de fuente. FontFamily
- Color: Especifica el color del texto usando color. IronWord.Models.Color
- bold y italic: Propiedades booleanas para formato en negrita y cursiva. IsBold
- underline: Añade estilo subrayado al texto. IsItalic
- strike-through: Aplica formato de tachado usando el enum StrikeValue. Underline
- Strike
Agregar al documento :
- Utiliza AddChild para añadir el Run estilizado a un Paragraph.
- El párrafo se añade luego al documento con AddParagraph.

Explicación del código

Este código muestra cómo crear y estilizar texto en un documento DOCX usando IronWord. Comienza inicializando un nuevo objeto WordDocument, que representa el documento a generar. Se crea un objeto Run que contiene TextContent con la cadena "Ejemplo de texto estilizado" y se aplica un TextStyle al Run para configurar la apariencia del texto.

El TextStyle incluye configuraciones para el tamaño de la fuente establecido a nivel de TextStyle (no dentro de Font), familia de fuentes configurada vía fontFamily, texto TextFont color y formato bold. Estas configuraciones personalizan cómo aparecerá el texto en el documento final.

Después de estilizar el Run, el método AddChild añade el objeto Run a un párrafo en el documento. Este método inserta el contenido estilizado en el documento de Word en el formato adecuado. Finalmente, se llama al método SaveAs para exportar el documento como "styled_document.docx". El resultado es un documento de Word donde el texto insertado está formateado según los estilos especificados, conservando todas las propiedades de fuente y formato en el archivo de salida.

Explora los tutoriales de elementos de documento para obtener más consejos de estilo.