Adicionar texto estilizado

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

Adicionar texto estilizado

O recurso "Adicionar texto estilizado" no IronWord permite que os desenvolvedores apliquem várias opções de estilo de texto ao adicionar conteúdo a um documento DOCX. Ele oferece controle preciso sobre a aparência do texto, como especificar a família da fonte, tamanho, cor e atributos de estilo como bold, italic, underline e strike-through. Ao criar um objeto Run contendo TextContent e atribuir um TextStyle ao Run, os desenvolvedores podem personalizar a apresentação de elementos de texto individuais dentro de um documento, garantindo uma aparência e um comportamento personalizados.

Essa funcionalidade é útil para gerar documentos formatados profissionalmente de forma dinâmica, como relatórios ou cartas, onde seções específicas exigem estilos distintos. A classe TextStyle permite a fácil manipulação desses atributos, possibilitando estilos simples e complexos dentro do mesmo documento.

Pontos-chave

Criando uma corrida estilizada :
- Um objeto Run é criado contendo TextContent com o texto desejado.
- A propriedade Style do objeto Run recebe um objeto TextStyle para aplicar a formatação. FontSize
Configurando o estilo do texto :
- TextStyle: Defina no nível TextStyle (não dentro de Font) para especificar o tamanho do texto.
- TextFont: Contém propriedades da fonte, incluindo fontFamily para seleção de fonte. FontFamily
- Color: Especifica a cor do texto usando color. IronWord.Models.Color
- bold e italic: Propriedades booleanas para formatação em negrito e itálico. IsBold
- underline: Adiciona estilo de sublinhado ao texto. IsItalic
- strike-through: Aplica formatação de tachado usando a enumeração StrikeValue. Underline
- Strike
Adicionando ao documento :
- Use AddChild para adicionar o Run estilizado a um Paragraph.
- O parágrafo é então adicionado ao documento com AddParagraph.

Explicação do código

Este código mostra como criar e estilizar texto em um documento DOCX usando o IronWord. Começa por inicializar um novo objeto WordDocument, que representa o documento a ser gerado. Um objeto Run é criado contendo TextContent com a string "Exemplo de texto estilizado" e um TextStyle é aplicado ao Run para configurar a aparência do texto.

O TextStyle inclui configurações para tamanho da fonte definidas no nível TextStyle (não dentro de Font), família da fonte configurada via fontFamily, texto TextFont e formatação color. Essas configurações personalizam a forma como o texto aparecerá no documento final.

Após o Run ser estilizado, o método AddChild adiciona o objeto Run a um parágrafo no documento. Este método insere o conteúdo formatado no documento do Word no formato apropriado. Finalmente, o método SaveAs é chamado para exportar o documento como "styled_document.docx". O resultado é um documento do Word onde o texto inserido é formatado de acordo com os estilos especificados, preservando todas as propriedades de fonte e formatação no arquivo de saída.

Explore os tutoriais de elementos de documento para obter mais dicas de estilo.