1. IronWord
  2. Tutoriais
  3. Efeito de brilho no texto
Como adicionar efeito de brilho ao texto em C#

How to Add Glow Effect to Text in C#

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

O efeito de brilho cria uma aura luminosa ao redor dos caracteres do texto. Esse efeito visual faz com que o texto pareça emitir luz com um contorno suave. Em aplicações C#, especialmente em documentos do Word, os efeitos de brilho ajudam a enfatizar cabeçalhos, títulos e conteúdo importante. O efeito é amplamente utilizado em apresentações, materiais de marketing e documentos profissionais onde o texto precisa de ênfase visual.

Início rápido: Aplique o efeito de brilho a um elemento de texto rapidamente

Crie um objeto Glow, defina seu GlowRadius e GlowColor, incorpore-o em um TextEffect e atribua ao estilo do seu texto. Uma única linha cria um texto brilhante no seu documento do Word.

  1. Instale IronWord com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronWord

  2. Copie e execute este trecho de código.

    using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { GlowEffect = new Glow() { GlowColor = IronWord.Models.Color.Aqua, GlowRadius = 10 } };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Glowing Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("glow.docx");

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronWord em seu projeto hoje com uma avaliação gratuita

    arrow pointer
### Como adicionar efeito de brilho ao texto (5 passos)
  1. Instale o IronWord: `Install-Package IronWord`
  2. Crie um `TextStyle` e configure `GlowEffect` com `GlowColor` e `GlowRadius`
  3. Crie uma `Run` contendo `TextContent` e atribua o `TextStyle` à `Run`
  4. Adicione o `Run` a um `Paragraph` usando `AddChild`
  5. Salve o documento

Como adicionar um efeito de brilho ao texto em C#?

Para aplicar um efeito de brilho, crie um TextStyle e preencha sua propriedade TextEffect com um GlowEffect. Em seguida, crie um Paragraph, seguido por um Run contendo TextContent. Atribua o TextStyle ao Run (não ao TextContent), e então use AddChild para adicionar o Run ao Paragraph. Isso segue a hierarquia do documento: Documento → Parágrafo → Execução → Conteúdo do Texto. Essa abordagem proporciona controle total sobre a aparência e a intensidade do brilho.

Por que é importante criar primeiro um objeto que brilha no escuro?

Criar um objeto Glow primeiro permite a configuração de todas as propriedades de brilho antes da aplicação. Isso segue os princípios da separação de responsabilidades e melhora a manutenção do código. A definição independente das propriedades de brilho permite a reutilização em vários elementos de texto e a modificação dinâmica com base nos requisitos da aplicação. Esse padrão corresponde à forma como outros produtos da Iron Software lidam com efeitos semelhantes, mantendo a consistência nos fluxos de trabalho de processamento de documentos.

using IronWord;
using IronWord.Models;
using System.Drawing;

public class TextGlowEffectExample
{
    public void ApplyGlowEffect()
    {
        // Create a new Word document
        WordDocument doc = new WordDocument();

        // Add a paragraph with text
        Paragraph paragraph = new Paragraph();
        Text textRun = new Text("This text has a bright glow!");
        paragraph.AddTextRun(textRun);

        // Initialize a new Glow object
        Glow glow = new Glow();

        // Set the properties for the glow effect
        glow.GlowRadius = 15; // Radius of the glow effect in points
        glow.GlowColor = Color.FromArgb(200, 0, 255, 255); // Semi-transparent cyan

        // Create a TextEffect object and assign the glow effect to it
        TextEffect textEffect = new TextEffect();
        textEffect.GlowEffect = glow;

        // Apply the TextEffect to the text
        textRun.Style = new TextStyle();
        textRun.Style.TextEffect = textEffect;

        // Add the paragraph to the document
        doc.AddParagraph(paragraph);

        // Salve o documento
        doc.SaveAs("glowing-text-example.docx");
    }
}
using IronWord;
using IronWord.Models;
using System.Drawing;

public class TextGlowEffectExample
{
    public void ApplyGlowEffect()
    {
        // Create a new Word document
        WordDocument doc = new WordDocument();

        // Add a paragraph with text
        Paragraph paragraph = new Paragraph();
        Text textRun = new Text("This text has a bright glow!");
        paragraph.AddTextRun(textRun);

        // Initialize a new Glow object
        Glow glow = new Glow();

        // Set the properties for the glow effect
        glow.GlowRadius = 15; // Radius of the glow effect in points
        glow.GlowColor = Color.FromArgb(200, 0, 255, 255); // Semi-transparent cyan

        // Create a TextEffect object and assign the glow effect to it
        TextEffect textEffect = new TextEffect();
        textEffect.GlowEffect = glow;

        // Apply the TextEffect to the text
        textRun.Style = new TextStyle();
        textRun.Style.TextEffect = textEffect;

        // Add the paragraph to the document
        doc.AddParagraph(paragraph);

        // Salve o documento
        doc.SaveAs("glowing-text-example.docx");
    }
}
$vbLabelText   $csharpLabel
Microsoft Word exibindo o texto 'Olá Mundo' com efeito de brilho ciano aplicado, demonstrando o resultado da formatação de brilho de texto.

Quais são as propriedades do efeito de brilho?

Compreender as propriedades do efeito de brilho é essencial para criar efeitos com aparência profissional que aprimorem os documentos sem sobrecarregar o conteúdo. O licenciamento adequado garante que esses recursos funcionem em ambientes de produção sem restrições.

Quais propriedades controlam a aparência do brilho?

  • GlowRadius: Define o raio do efeito de brilho em pontos (1/72 polegada). Os valores normalmente variam de 5 a 30 pontos. Valores maiores criam brilhos mais difusos e dispersos. Um raio de 5 a 10 pontos cria destaques sutis; 20 a 30 pontos produzem halos dramáticos.

  • GlowColor: Define a cor do efeito de brilho. Aceita valores System.Drawing.Color, incluindo ARGB para controle de transparência. Cores brilhantes (ciano, amarelo, magenta) criam efeitos vibrantes; Cores mais escuras proporcionam uma ênfase sutil.

Como faço para definir valores de cor com transparência alfa?

A transparência alfa cria efeitos de brilho realistas que se misturam naturalmente com os fundos. Os valores alfa variam de 0 (transparente) a 255 (opaco). Aqui está um exemplo mostrando diferentes valores alfa:

using IronWord;
using IronWord.Models;
using System.Drawing;

public class AlphaTransparencyExample
{
    public void DemonstrateAlphaValues()
    {
        WordDocument doc = new WordDocument();

        // Create multiple text samples with different alpha values
        int[] alphaValues = { 50, 100, 150, 200, 255 };

        foreach (int alpha in alphaValues)
        {
            Paragraph para = new Paragraph();
            Text text = new Text($"Alpha: {alpha} - Glow Effect Sample");

            // Create glow with specific alpha transparency
            Glow glow = new Glow
            {
                GlowRadius = 12,
                GlowColor = Color.FromArgb(alpha, 255, 215, 0) // Gold with varying transparency
            };

            // Apply the glow effect
            TextEffect effect = new TextEffect { GlowEffect = glow };
            text.Style = new TextStyle 
            { 
                TextEffect = effect,
                FontSize = 24,
                FontFamily = "Arial"
            };

            para.AddTextRun(text);
            doc.AddParagraph(para);
        }

        doc.SaveAs("alpha-transparency-demo.docx");
    }
}
using IronWord;
using IronWord.Models;
using System.Drawing;

public class AlphaTransparencyExample
{
    public void DemonstrateAlphaValues()
    {
        WordDocument doc = new WordDocument();

        // Create multiple text samples with different alpha values
        int[] alphaValues = { 50, 100, 150, 200, 255 };

        foreach (int alpha in alphaValues)
        {
            Paragraph para = new Paragraph();
            Text text = new Text($"Alpha: {alpha} - Glow Effect Sample");

            // Create glow with specific alpha transparency
            Glow glow = new Glow
            {
                GlowRadius = 12,
                GlowColor = Color.FromArgb(alpha, 255, 215, 0) // Gold with varying transparency
            };

            // Apply the glow effect
            TextEffect effect = new TextEffect { GlowEffect = glow };
            text.Style = new TextStyle 
            { 
                TextEffect = effect,
                FontSize = 24,
                FontFamily = "Arial"
            };

            para.AddTextRun(text);
            doc.AddParagraph(para);
        }

        doc.SaveAs("alpha-transparency-demo.docx");
    }
}
$vbLabelText   $csharpLabel

Diretrizes para o valor alfa:

  • 50-100 : Efeitos muito sutis, quase imperceptíveis, no estilo de marca d'água.
  • 100-150 : Brilho suave, aparência profissional para documentos comerciais
  • 150-200 : Intensidade média, equilibrada para cabeceios e títulos.
  • 200-255 : Brilho intenso, alto impacto para materiais promocionais

Quais são alguns exemplos de efeitos de brilho?

Os efeitos de brilho aceitam valores de cor ARGB. O valor alfa controla a opacidade. Estes exemplos mostram aplicações práticas do efeito glow em diversos contextos de documentos. Configure as chaves de licença adequadas antes da implementação em produção.

Quando devo usar valores de raio diferentes?

Valores de raio diferentes servem a propósitos diferentes. Raios pequenos (5 a 10 pontos) criam brilhos focados para dar ênfase sutil a termos ou links. Raios médios (15-20 pontos) funcionam bem para cabeçalhos e títulos de seção, proporcionando uma hierarquia clara. Raios grandes (mais de 25 pontos) são ideais para capas de revistas ou chamadas promocionais que precisam de máximo impacto.

Aqui está uma implementação mostrando aplicações RADIUS:

public class RadiusExamples
{
    public void CreateRadiusComparison()
    {
        WordDocument doc = new WordDocument();

        // Example 1: Subtle emphasis for inline text
        Paragraph p1 = new Paragraph();
        Text subtleText = new Text("Important: This deadline cannot be extended.");
        subtleText.Style = new TextStyle
        {
            TextEffect = new TextEffect
            {
                GlowEffect = new Glow
                {
                    GlowRadius = 6,
                    GlowColor = Color.FromArgb(180, 255, 0, 0) // Soft red glow
                }
            }
        };
        p1.AddTextRun(subtleText);

        // Example 2: Section header with medium glow
        Paragraph p2 = new Paragraph();
        Text headerText = new Text("Chapter 1: Getting Started");
        headerText.Style = new TextStyle
        {
            FontSize = 28,
            FontFamily = "Calibri",
            TextEffect = new TextEffect
            {
                GlowEffect = new Glow
                {
                    GlowRadius = 18,
                    GlowColor = Color.FromArgb(150, 0, 120, 215) // Corporate blue
                }
            }
        };
        p2.AddTextRun(headerText);

        // Example 3: Promotional text with large glow
        Paragraph p3 = new Paragraph();
        Text promoText = new Text("SPECIAL OFFER - LIMITED TIME!");
        promoText.Style = new TextStyle
        {
            FontSize = 36,
            Bold = true,
            TextEffect = new TextEffect
            {
                GlowEffect = new Glow
                {
                    GlowRadius = 30,
                    GlowColor = Color.FromArgb(220, 255, 255, 0) // Bright yellow
                }
            }
        };
        p3.AddTextRun(promoText);

        doc.AddParagraph(p1);
        doc.AddParagraph(p2);
        doc.AddParagraph(p3);
        doc.SaveAs("radius-examples.docx");
    }
}
public class RadiusExamples
{
    public void CreateRadiusComparison()
    {
        WordDocument doc = new WordDocument();

        // Example 1: Subtle emphasis for inline text
        Paragraph p1 = new Paragraph();
        Text subtleText = new Text("Important: This deadline cannot be extended.");
        subtleText.Style = new TextStyle
        {
            TextEffect = new TextEffect
            {
                GlowEffect = new Glow
                {
                    GlowRadius = 6,
                    GlowColor = Color.FromArgb(180, 255, 0, 0) // Soft red glow
                }
            }
        };
        p1.AddTextRun(subtleText);

        // Example 2: Section header with medium glow
        Paragraph p2 = new Paragraph();
        Text headerText = new Text("Chapter 1: Getting Started");
        headerText.Style = new TextStyle
        {
            FontSize = 28,
            FontFamily = "Calibri",
            TextEffect = new TextEffect
            {
                GlowEffect = new Glow
                {
                    GlowRadius = 18,
                    GlowColor = Color.FromArgb(150, 0, 120, 215) // Corporate blue
                }
            }
        };
        p2.AddTextRun(headerText);

        // Example 3: Promotional text with large glow
        Paragraph p3 = new Paragraph();
        Text promoText = new Text("SPECIAL OFFER - LIMITED TIME!");
        promoText.Style = new TextStyle
        {
            FontSize = 36,
            Bold = true,
            TextEffect = new TextEffect
            {
                GlowEffect = new Glow
                {
                    GlowRadius = 30,
                    GlowColor = Color.FromArgb(220, 255, 255, 0) // Bright yellow
                }
            }
        };
        p3.AddTextRun(promoText);

        doc.AddParagraph(p1);
        doc.AddParagraph(p2);
        doc.AddParagraph(p3);
        doc.SaveAs("radius-examples.docx");
    }
}
$vbLabelText   $csharpLabel

Quais são as combinações de cores mais comuns para efeitos de brilho?

Combinações de cores eficazes dependem da finalidade do documento e da identidade visual da marca. Documentos profissionais utilizam tons sutis de azul, cinza ou cores da marca com valores alfa mais baixos. Os materiais de marketing empregam cores complementares vibrantes ou combinações de alto contraste. Verifique as atualizações de produto para garantir a compatibilidade ao usar vários produtos da Iron Software .

Combinações de cores comuns:

  1. Azul Profissional : Texto azul marinho com leve brilho azul (RGB: 100, 150, 255)
  2. Ênfase Quente : Texto marrom escuro com brilho dourado (RGB: 255, 200, 50)
  3. Alto contraste : Texto preto com brilho branco/prateado (RGB: 220, 220, 220)
  4. Cores da marca : Texto na cor da empresa com brilho complementar.
  5. Temas Sazonais : Verde/vermelho para feriados, laranja/preto para o Halloween
Quatro exemplos de texto mostrando efeitos de brilho: azul-turquesa 10pt, azul-celeste 20pt, dourado 30pt e verde personalizado com raio de 40pt

Os efeitos de brilho devem melhorar a legibilidade, e não prejudicá-la. Teste combinações em diferentes planos de fundo e siga as diretrizes de acessibilidade. Para aplicações empresariais que necessitam de suporte prolongado, explore as extensões de licenciamento para atualizações e funcionalidades contínuas. Ao dimensionar aplicações, as opções de atualização oferecem flexibilidade para equipes em crescimento e requisitos cada vez maiores.

Perguntas frequentes

Como adiciono um efeito de brilho ao texto em documentos do Word usando C#?

Para adicionar um efeito de brilho usando o IronWord, crie um objeto Glow com o raio e as configurações de cor desejadas, incorpore-o em um objeto TextEffect e atribua-o à propriedade Style.TextEffect do seu elemento de texto. Isso pode ser feito em uma única linha: someTextElement.Style.TextEffect = new IronWord.Models.TextEffect { GlowEffect = new IronWord.Models.Glow { GlowRadius = 8, GlowColor = System.Drawing.Color.FromArgb(180, 0, 128, 255) } };

Qual é o código mínimo necessário para criar texto brilhante?

O IronWord permite criar texto brilhante com apenas uma linha de código, definindo a propriedade `Style.TextEffect` do elemento de texto com um novo `TextEffect` contendo um objeto `Glow` configurado. Isso inclui definir o raio e a cor do brilho em uma única instrução.

Posso personalizar a aparência do efeito de brilho?

Sim, o IronWord oferece personalização completa dos efeitos de brilho através das propriedades do objeto Glow. Você pode ajustar o GlowRadius (em pontos) para controlar o tamanho do brilho e definir a cor GlowColor usando System.Drawing.Color com valores ARGB para um controle preciso de cor e transparência.

Por que eu deveria criar um objeto Glow separado em vez de usar a configuração embutida?

Criar um objeto Glow separado no IronWord segue os princípios de separação de responsabilidades e melhora a manutenção do código. Essa abordagem permite reutilizar a mesma configuração de brilho em vários elementos de texto e modificar propriedades dinamicamente com base nos requisitos do aplicativo, seguindo o padrão consistente usado em outros produtos da Iron Software.

Quais são os principais passos para aplicar um efeito de brilho ao texto?

O fluxo de trabalho no IronWord envolve 5 etapas: 1) Baixar a biblioteca IronWord C#, 2) Aplicar o efeito de texto a um texto novo ou existente, 3) Configurar um objeto Glow com configurações de raio e cor, 4) Atribuir o efeito Glow à propriedade GlowEffect de um objeto TextEffect, 5) Exportar o documento Word editado como um novo arquivo.

Que tipos de documentos se beneficiam de efeitos de brilho no texto?

O recurso de efeito de brilho do IronWord é particularmente útil para criar apresentações, materiais de marketing e documentos profissionais onde o texto precisa de destaque visual. O efeito de aura luminosa ajuda a realçar cabeçalhos, títulos e conteúdo importante em documentos do Word.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 35,581 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronWord
executar um exemplo Veja seus dados se transformarem em um documento do Word.