Como Implementar Cores Personalizadas no Código QR

Atualizado:janeiro 1, 2026

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 de códigos 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.

Instale IronQR com o Gerenciador de Pacotes NuGet
PM > Install-Package IronQR

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");

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

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

### Fluxo de trabalho mínimo (5 etapas)

Baixar a biblioteca C# para criar códigos QR com cores personalizadas
Crie um código QR usando a classe `QrWriter`
Inicialize `QrStyleOptions` para configurar a aparência
Defina as propriedades `Color` e `BackgroundColor`
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");

$vbLabelText $csharpLabel

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");

$vbLabelText $csharpLabel

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

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 ...