How to Add Style to Text in DOCX with C#

Que resultado isso irá gerar?

A classe TextStyle fornece opções de formatação essenciais, incluindo propriedades de fonte, cor do texto, negrito, itálico e sublinhado. Note que FontSize é configurado no nível TextStyle (não dentro do Font), enquanto FontFamily é definido dentro da propriedade TextFont. O objeto Run encapsula o TextContent e mantém o estilo, seguindo o padrão de hierarquia de documentos do IronWord. O exemplo demonstra como múltiplas propriedades de estilo se combinam para criar texto ricamente formatado quando aplicadas a um Run.

Como faço para alterar a cor do texto?

A propriedade Color em TextStyle define a cor do texto usando cores predefinidas de IronWord.Models.Color ou valores hex personalizados. Isso enfatiza conteúdo específico ou combina com as cores da marca. IronWord suporta uma ampla gama de cores, incluindo vermelho, azul, verde, oliva, marinho e bordô.

:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-text.cs

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add colored text
Run textRun = new Run(new TextContent("This text is olive-colored!"));
textRun.Style = new TextStyle()
{
    Color = IronWord.Models.Color.Olive // defining text to be colored olive
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("colored-text.docx");

Qual a aparência do texto colorido?

Como faço para definir a família e o tamanho da fonte?

Personalize a aparência do texto com a propriedade TextFont. Defina FontFamily para qualquer nome de fonte instalado (por exemplo, "Arial", "Times New Roman") e FontSize em pontos. Isso estabelece uma hierarquia visual e garante a legibilidade em diferentes dispositivos e plataformas.

:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-font.cs

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add text with custom font family and size
Run textRun = new Run(new TextContent("This text uses Arial at 24pt!"));
textRun.Style = new TextStyle()
{
    FontSize = 24,  // Set font size in points
    TextFont = new IronWord.Models.Font()
    {
        FontFamily = "Arial"  // Set font family
    }
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("font-styled-text.docx");

Como fica a estilização de fontes personalizadas?

Como faço para deixar o texto em negrito?

Defina a propriedade IsBold para true para tornar o texto em negrito. O texto em negrito é comumente usado para títulos, ênfase ou para destacar informações importantes. Combinado com outras propriedades de estilo, o texto em negrito cria hierarquia visual e melhora a legibilidade.

:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-bold.cs

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add bold text
Run textRun = new Run(new TextContent("this is bold!"));
textRun.Style = new TextStyle()
{
    IsBold = true  // Make text bold
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("bold-text.docx");

Qual a aparência do texto em negrito?

Como faço para deixar o texto em itálico?

Defina a propriedade IsItalic para true para estilo itálico. O texto em itálico é normalmente usado para dar ênfase, em títulos, palavras estrangeiras ou termos técnicos. Essa formatação sutil diferencia os elementos de texto sem o peso visual da formatação em negrito.

:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-italic.cs

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add italic text
Run textRun = new Run(new TextContent("this is italic."));
textRun.Style = new TextStyle()
{
    IsItalic = true  // Make text italic
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("italic-text.docx");

Qual é a aparência do texto em itálico?

Combinando vários estilos

O poder de estilização de texto do IronWord vem da combinação de múltiplas propriedades para alcançar formatação complexa. Aqui está um exemplo que demonstra um texto formatado profissionalmente, combinando várias propriedades de estilo:

using IronWord;
using IronWord.Models;

// Create a new document
WordDocument doc = new WordDocument();

// Create richly formatted header text using Run
Run headerRun = new Run(new TextContent("Professional Document Header"));
headerRun.Style = new TextStyle()
{
    FontSize = 28,
    TextFont = new Font()
    {
        FontFamily = "Georgia"
    },
    Color = Color.DarkBlue,
    IsBold = true,
    SmallCaps = true,
    Underline = new Underline(),
    CharacterScale = 110,  // Slightly expand character width
    Shading = new Shading()
    {
        Color = Color.LightGray  // Light background
    }
};

// Add header to document using AddChild for styled Run
Paragraph headerParagraph = new Paragraph();
headerParagraph.AddChild(headerRun);
doc.AddParagraph(headerParagraph);

// Create body text with different styling
Run bodyRun = new Run(new TextContent("This is professionally formatted body text with custom styling."));
bodyRun.Style = new TextStyle()
{
    FontSize = 11,
    TextFont = new Font()
    {
        FontFamily = "Calibri"
    },
    Color = Color.Black,
    LineSpacing = new LineSpacing() { Value = 1.15 }  // Slightly increased line spacing
};

Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);

// Save the document
doc.SaveAs("professional-document.docx");

using IronWord;
using IronWord.Models;

// Create a new document
WordDocument doc = new WordDocument();

// Create richly formatted header text using Run
Run headerRun = new Run(new TextContent("Professional Document Header"));
headerRun.Style = new TextStyle()
{
    FontSize = 28,
    TextFont = new Font()
    {
        FontFamily = "Georgia"
    },
    Color = Color.DarkBlue,
    IsBold = true,
    SmallCaps = true,
    Underline = new Underline(),
    CharacterScale = 110,  // Slightly expand character width
    Shading = new Shading()
    {
        Color = Color.LightGray  // Light background
    }
};

// Add header to document using AddChild for styled Run
Paragraph headerParagraph = new Paragraph();
headerParagraph.AddChild(headerRun);
doc.AddParagraph(headerParagraph);

// Create body text with different styling
Run bodyRun = new Run(new TextContent("This is professionally formatted body text with custom styling."));
bodyRun.Style = new TextStyle()
{
    FontSize = 11,
    TextFont = new Font()
    {
        FontFamily = "Calibri"
    },
    Color = Color.Black,
    LineSpacing = new LineSpacing() { Value = 1.15 }  // Slightly increased line spacing
};

Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);

// Save the document
doc.SaveAs("professional-document.docx");

Essa abordagem de formatação abrangente cria documentos que mantêm uma identidade visual consistente e uma aparência profissional em todo o processo de geração de documentos da sua aplicação.