1. IronQR
  2. Tutoriais
  3. Implementar Cores Personalizadas no Código QR

Como Implementar Cores Personalizadas no Código QR

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

Os códigos QR evoluíram de padrões simples em preto e branco para ferramentas poderosas de branding. Em 2025, as empresas reconhecem que um código QR bem desenhado pode reforçar a identidade da marca mantendo total escaneabilidade. Personalizar as cores do primeiro plano e do fundo de seus códigos QR permite criar designs visualmente atraentes que se destacam.

IronQR torna simples modificar as cores do código QR usando a classe QrStyleOptions. Você pode mudar a cor do primeiro plano (os módulos escuros), a cor de fundo ou ambas para corresponder às diretrizes da sua marca.

Neste guia passo a passo, mostraremos diferentes maneiras de personalizar cores ao criar código QR usando IronQR em C#.

Início Rápido: Personalizar Cores do Código QR

Defina as cores de primeiro plano e de fundo através de QrStyleOptions e salve o código QR estilizado.

  1. Instale IronQR com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronQR

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

    var qrCode = QrWriter.Write("https://example.com");
var style = new QrStyleOptions { Color = Color.DarkBlue, BackgroundColor = Color.LightYellow };
qrCode.Save(style).SaveAs("colored-qr.png");

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

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

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)
  1. Baixar a biblioteca C# para criar códigos QR com cores personalizadas
  2. Crie um código QR usando a classe `QrWriter`
  3. Inicialize `QrStyleOptions` para configurar a aparência
  4. Defina as propriedades `Color` e `BackgroundColor`
  5. Salve o código QR estilizado usando `SaveAs`

Mudar Cor de Fundo

A cor de fundo de um código QR é a área mais clara ao redor dos módulos escuros. Por padrão, esta é branca, mas você pode mudá-la para qualquer cor que forneça contraste suficiente com o primeiro plano.

Definir uma cor de fundo personalizada é útil ao colocar códigos QR em superfícies coloridas ou quando você deseja combinar com a paleta de cores da sua marca. Apenas garanta que há contraste suficiente para que os scanners leiam o código de maneira confiável.

:path=/static-assets/qr/content-code-examples/how-to/implement-custom-qr-code-background.cs
using IronQr;
using IronSoftware.Drawing;

// Create a QR code
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");

// Set background color
QrStyleOptions styleOptions = new QrStyleOptions()
{
    BackgroundColor = Color.LightBlue
};

// Save QR code with custom background
AnyBitmap qrImage = qr.Save(styleOptions);
qrImage.SaveAs("qrBackgroundColor.png");
Imports IronQr
Imports IronSoftware.Drawing

' Create a QR code
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")

' Set background color
Dim styleOptions As New QrStyleOptions() With {
    .BackgroundColor = Color.LightBlue
}

' Save QR code with custom background
Dim qrImage As AnyBitmap = qr.Save(styleOptions)
qrImage.SaveAs("qrBackgroundColor.png")
$vbLabelText   $csharpLabel
Código QR com cor de fundo personalizada

Mudar Cor do Primeiro Plano

A cor do primeiro plano representa os módulos escuros do código QR — o padrão real de dados que os scanners leem. Enquanto preto é a escolha padrão, você pode usar qualquer cor mais escura que mantenha um bom contraste com seu fundo.

Mudar a cor do primeiro plano permite que você incorpore a cor primária da sua marca no design do código QR. Azuis profundos, verdes escuros ou vinhos ricos funcionam bem como alternativas ao preto.

:path=/static-assets/qr/content-code-examples/how-to/implement-custom-qr-code-foreground.cs
using IronQr;
using IronSoftware.Drawing;

// Create a QR code
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");

// Set background color
QrStyleOptions styleOptions = new QrStyleOptions()
{
    Color = Color.PaleVioletRed
};

// Save QR code with custom background
AnyBitmap qrImage = qr.Save(styleOptions);
qrImage.SaveAs("qrBackgroundColor.png");
Imports IronQr
Imports IronSoftware.Drawing

' Create a QR code
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")

' Set background color
Dim styleOptions As New QrStyleOptions() With {
    .Color = Color.PaleVioletRed
}

' Save QR code with custom background
Dim qrImage As AnyBitmap = qr.Save(styleOptions)
qrImage.SaveAs("qrBackgroundColor.png")
$vbLabelText   $csharpLabel
Código QR com cor de primeiro plano personalizada

Conclusão

Personalizar as cores do código QR com IronQR abre possibilidades criativas enquanto mantém seus códigos totalmente funcionais:

  • Cor de Fundo: Use BackgroundColor para mudar a área mais clara atrás do padrão QR
  • Cor de Primeiro Plano: Use Color para modificar os módulos escuros que codificam seus dados
  • Estilização Combinada: Defina ambas as propriedades juntas para alinhamento completo da marca

Lembre-se de manter contraste adequado entre as cores de primeiro plano e de fundo para garantir a leitura confiável através de diferentes dispositivos e condições de iluminação.

Para mais opções de estilização, incluindo logotipos, margens e dimensões, visite a documentação do IronQR ou explore exemplos adicionais de código no GitHub.

Ahmad Sohail
Ahmad Sohail
  Converse agora mesmo com a equipe de engenharia.
Desenvolvedor Full Stack

Ahmad é um desenvolvedor full-stack com uma sólida base em C#, Python e tecnologias web. Ele tem um grande interesse em construir soluções de software escaláveis e gosta de explorar como design e funcionalidade se encontram em aplicações do mundo real.

Antes de se ...

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

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronQR
executar um exemplo Veja seu URL se transformar em um código QR.