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, permitindo especificar a família da fonte, o tamanho, a cor e atributos de estilo como negrito, itálico, sublinhado e tachado. 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 em um documento, garantindo um visual personalizado.

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, permitindo tanto uma formatação simples quanto complexa dentro do mesmo documento.

Pontos-chave

Criando uma corrida estilizada :
- A Run object is created containing TextContent with the desired text.
- The Style property of the Run is assigned a TextStyle object to apply formatting.
Configurando o estilo do texto :
- FontSize: Set at the TextStyle level (not inside Font) to specify text size.
- TextFont: Contains font properties including FontFamily for font selection.
- Color: Specifies the text color using IronWord.Models.Color.
- IsBold and IsItalic: Boolean properties for bold and italic formatting.
- Underline: Adds underline styling to the text.
- Strike: Applies strikethrough formatting using StrikeValue enum.
Adicionando ao documento :
- Use AddChild to add the styled Run to a Paragraph.
- The paragraph is then added to the document with AddParagraph.

Explicação do código

Este código mostra como criar e estilizar texto em um documento DOCX usando o IronWord. It begins by initializing a new WordDocument object, representing the document to be generated. A Run object is created containing TextContent with the string "Styled text example" and a TextStyle is applied to the Run to configure the appearance of the text.

The TextStyle includes settings for font size set at the TextStyle level (not inside Font), font family configured via TextFont, text color, and bold formatting. Essas configurações personalizam a forma como o texto aparecerá no documento final.

After the Run is styled, the AddChild method adds the Run object to a paragraph in the document. Este método insere o conteúdo formatado no documento do Word no formato apropriado. Finally, the SaveAs method is called to export the document as "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.