C# Document Element Tutorial

Hierarquia de Documentos

O IronWord segue uma hierarquia de documentos estruturada: Documento → Parágrafo → Execução → Conteúdo do Texto . Compreender essa hierarquia é essencial para trabalhar com texto formatado:

• WordDocument: O contêiner de nível superior que representa o documento inteiro
• Paragraph: Um bloco de conteúdo dentro do documento
• Run: Um objeto encapsulador que contém TextContent e pode ter estilo aplicado
• TextContent: A string de texto real

Adicionando conteúdo aos parágrafos

O IronWord oferece dois métodos para adicionar conteúdo aos parágrafos:

• AddText(TextContent): Use para texto simples sem estilo. Adiciona TextContent diretamente ao parágrafo.
• AddChild(Run): Use para texto com estilo. Adiciona um objeto Run (que encapsula TextContent e contém estilo) ao parágrafo.

Quando você precisa aplicar estilos como tamanho da fonte, cor ou formatação em negrito, crie um objeto Run, atribua um TextStyle ao Run, e use AddChild para adicioná-lo ao parágrafo.

Conteúdo do texto

O método Split é utilizado para dividir a execução do texto em uma lista de execuções de texto menores, com base em um delimitador especificado. Isso permite a organização e manipulação de informações textuais dentro do documento.

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

using 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");

Estilização de Conjunto

Definir o estilo para texto requer o uso do padrão de encapsulamento Run. Crie um objeto Run contendo TextContent, depois atribua um TextStyle ao Run (não ao TextContent). O TextStyle permite definir atributos visuais como FontSize, cor, negrito, itálico, tachado, sublinhado, sobrescrito e subscrito.

Note que FontSize é configurado no nível TextStyle, enquanto FontFamily é definido dentro da propriedade TextFont. Uma vez estilizado, use AddChild para adicionar o Run a um parágrafo. Isso segue a hierarquia do documento: Documento → Parágrafo → Execução → Conteúdo do Texto.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs

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 = 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");

Obter cor de preenchimento do texto

Além de definir estilos, o IronWord oferece uma maneira de obter o valor de cor RGBA de documentos existentes para manter a consistência em todo o estilo.

:path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs

using IronWord;
using IronWord.Models;
using System;

// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");

TextContent content = doc.Paragraphs[0].Texts[0];

// This will show the R G B A of the themecolor
var filledColor = content.Color;

// Print the filled color variable to the console
Console.WriteLine(filledColor);

Para recuperar valores de cor, carregue o documento usando WordDocument, depois acesse a coleção Paragraphs e o array Texts para obter o objeto TextContent. A propriedade Color de TextContent retorna o valor RGBA da cor existente do texto, permitindo que você mantenha um estilo consistente em todo o seu documento.

Incorporar imagens

Essa funcionalidade permite incluir imagens no conteúdo de forma integrada, aprimorando o apelo visual geral e o poder de comunicação do documento.

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

using 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");

Carregar imagem

Carregar imagens é um processo crucial. Isso envolve a inclusão de arquivos de imagem externos no documento. A possibilidade de carregar imagens facilita a inclusão de elementos visuais relevantes, contribuindo para um documento mais envolvente e informativo.

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

using 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");

Configurar imagem

Otimize as imagens com configurações personalizáveis. Isso inclui definir propriedades como quebra de texto, dimensões, posição e distância dos cantos. Uma configuração adequada garante que as imagens sejam exibidas de maneira visualmente agradável e contextualizada.

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
using IronSoftware.Abstractions.Word;

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

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.TextWrapBehavior = new TextWrapSquare();
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");