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
-
Agregar Texto
-
Contenido de Texto (Agregar, Adjuntar y Dividir)
- Configurar Estilo (Familia y Tamaño de Fuente, Color, Negrita e Italica, Tachado, Subrayado, Superíndice y Subíndice)
-
- Incorporar Imágenes
-
Agregar imágenes
-
Cargar imagen (Archivo y FileStream)
-
Establecer Dimensiones (Ancho y Altura)
- Establecer distancia desde las esquinas
Comienza con IronWORD
Comience a usar IronWord en su proyecto hoy con una prueba gratuita.
-
Añadir TextRuns
Contenido del texto
El método Split se utiliza para dividir la ejecución del 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.csusing IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));
// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));
// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));
// Export docx
doc.SaveAs("textrun.docx");Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))
' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))
' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))
' Export docx
doc.SaveAs("textrun.docx")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.csusing IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
TextContent textRun = new TextContent();
textRun.Text = "Add text using IronWord";
textRun.Style = new TextStyle()
{
TextFont = new Font()
{
FontFamily = "Caveat",
FontSize = 72,
},
Color = Color.Red,
IsBold = true,
IsItalic = true,
Underline = new Underline(),
Strike = StrikeValue.Strike,
};
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(textRun);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Private doc As New WordDocument("document.docx")
' Configure text
Private textRun As New TextContent()
textRun.Text = "Add text using IronWord"
textRun.Style = New TextStyle() With {
.TextFont = New Font() With {
.FontFamily = "Caveat",
.FontSize = 72
},
.Color = Color.Red,
.IsBold = True,
.IsItalic = True,
.Underline = New Underline(),
.Strike = StrikeValue.Strike
}
Dim paragraph As New Paragraph()
' Add text
paragraph.AddText(textRun)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")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.csusing IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();
// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);
// Add paragraph
doc.AddParagraph(new Paragraph(textRun));
// Export docx
doc.SaveAs("save_document.docx");Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
' Configure image
Private image As New ImageContent("image.jpg")
image.Width = 200 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim textRun As New TextContent()
' Add image
Dim para As New Paragraph(textRun)
para.AddImage(image)
' Add paragraph
doc.AddParagraph(New Paragraph(textRun))
' Export docx
doc.SaveAs("save_document.docx")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.csusing IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
Paragraph paragraph = new Paragraph();
// Add image
paragraph.AddImage("image.jpg");
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("document.docx");Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
Private paragraph As New Paragraph()
' Add image
paragraph.AddImage("image.jpg")
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("document.docx")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.csusing IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("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();
// Add image
paragraph.AddImage(image);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("document.docx");Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Private doc As New WordDocument()
' Configure image
Private image As New ImageContent("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()
' Add image
paragraph.AddImage(image)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("document.docx")
