1. IronWord
  2. Tutoriales
  3. Elemento del documento

Tutorial de elementos de documento

IronWord es una potente biblioteca de documentos Word diseñada para ayudar a los desarrolladores .NET C# a integrar las funciones de creación, lectura y edición de documentos Word y DOCX en sus aplicaciones. En el contexto de un documento Word, los elementos del documento son los bloques que componen el contenido.

Índice

Añadir TextRuns

Contenido del texto

El método Split se utiliza para dividir la ejecución de texto en una lista de TextRuns más pequeños, basándose en un delimitador especificado. Permite organizar y manipular la información textual del documento.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs
using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

//  Añadir texto
Text addText = new Text("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

//  Añadir texto
Text appendText = new Text("The first text.");
appendText.Append(new Text("The second text."));
doc.AddParagraph(new Paragraph(appendText));

//  Texto dividido
Text splitText = new Text("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

//  Exportar docx
doc.SaveAs("textrun.docx");
Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

'  Añadir texto
Private addText As New Text("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

'  Añadir texto
Dim appendText As New Text("The first text.")
appendText.Append(New Text("The second text."))
doc.AddParagraph(New Paragraph(appendText))

'  Texto dividido
Dim splitText As New Text("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

'  Exportar docx
doc.SaveAs("textrun.docx")
VB   C#

Set Styling

La configuración de estilos para TextRuns permite definir la presentación visual del texto. Esto incluye la especificación de atributos como tamaño de letra, color, estilo, tachado, subrayado, superíndice y subíndice. La configuración del estilo mejora el aspecto general del texto en el documento.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs
using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;

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

//  Configurar texto
Text textRun = new Text();
textRun.Text = "Add text using IronWord";
textRun.Style = new TextStyle()
{
    FontFamily = "Caveat",
    FontSize = 72,
    TextColor = new IronColor(Color.Red),
    IsBold = true,
    IsItalic = true,
    IsUnderline = true,
    IsSuperscript = false,
    IsStrikethrough = true,
    IsSubscript = false
};

Paragraph paragraph = new Paragraph();

//  Añadir texto
paragraph.AddText(textRun);

//  Añadir párrafo
doc.AddParagraph(paragraph);

//  Exportar docx
doc.SaveAs("save_document.docx");
Imports IronSoftware.Drawing
Imports IronWord
Imports IronWord.Models

'  Cargar docx
Private doc As New WordDocument("document.docx")

'  Configurar texto
Private textRun As New Text()
textRun.Text = "Add text using IronWord"
textRun.Style = New TextStyle() With {
	.FontFamily = "Caveat",
	.FontSize = 72,
	.TextColor = New IronColor(Color.Red),
	.IsBold = True,
	.IsItalic = True,
	.IsUnderline = True,
	.IsSuperscript = False,
	.IsStrikethrough = True,
	.IsSubscript = False
}

Dim paragraph As New Paragraph()

'  Añadir texto
paragraph.AddText(textRun)

'  Añadir párrafo
doc.AddParagraph(paragraph)

'  Exportar docx
doc.SaveAs("save_document.docx")
VB   C#

Incrustar imágenes

Esta función le permite incluir imágenes en el contenido, lo que aumenta el atractivo visual y la fuerza comunicativa del documento.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs
using IronWord;
using IronWord.Models;

//  Cargar docx
WordDocument doc = new WordDocument();

//  Configurar imagen
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 200; //  En píxel unitario
image.Height = 200; //  En píxel unitario
Text textRun = new Text();

//  Añadir imagen
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

//  Añadir párrafo
doc.AddParagraph(new Paragraph(textRun));

//  Exportar docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

'  Cargar docx
Private doc As New WordDocument()

'  Configurar imagen
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 200 '  En píxel unitario
image.Height = 200 '  En píxel unitario
Dim textRun As New Text()

'  Añadir imagen
Dim para As New Paragraph(textRun)
para.AddImage(image)

'  Añadir párrafo
doc.AddParagraph(New Paragraph(textRun))

'  Exportar docx
doc.SaveAs("save_document.docx")
VB   C#

Añadir imágenes

Cargar imagen

La carga de imágenes es un proceso crucial. Se trata de introducir archivos de imagen externos en el documento. La posibilidad de cargar imágenes facilita la inclusión de elementos visuales relevantes, contribuyendo a un documento más atractivo e informativo.

:path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs
using IronWord;
using IronWord.Models;

//  Cargar docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

//  Añadir imagen
paragraph.AddImage("image.jpg");

//  Añadir párrafo
doc.AddParagraph(paragraph);

//  Exportar docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

'  Cargar docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

'  Añadir imagen
paragraph.AddImage("image.jpg")

'  Añadir párrafo
doc.AddParagraph(paragraph)

'  Exportar docx
doc.SaveAs("document.docx")
VB   C#

Configurar imagen

Optimiza las imágenes con ajustes configurables. Esto incluye la configuración de propiedades como el ajuste del texto, las dimensiones, la posición y la distancia a las esquinas. Una configuración adecuada garantiza que las imágenes se muestren de forma visualmente agradable y contextualmente apropiada.

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

//  Cargar docx
WordDocument doc = new WordDocument();

//  Configurar imagen
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.WrapText = WrapText.Square;
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

//  Añadir imagen
paragraph.AddImage(image);

//  Añadir párrafo
doc.AddParagraph(paragraph);

//  Exportar docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

'  Cargar docx
Private doc As New WordDocument()

'  Configurar imagen
Private image As New IronWord.Models.Image("image.jpg")
image.WrapText = WrapText.Square
image.Width = 100
image.Height = 100
image.DistanceFromTop = 50

Dim position = New ElementPosition()
position.X = 50
position.Y = 50
image.Position = position

Dim paragraph As New Paragraph()

'  Añadir imagen
paragraph.AddImage(image)

'  Añadir párrafo
doc.AddParagraph(paragraph)

'  Exportar docx
doc.SaveAs("document.docx")
VB   C#