Como adicionar margens a códigos QR

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

Dimensionar corretamente um código QR é um passo vital para equilibrar o impacto visual com a legibilidade técnica na publicidade da marca. Para alcançar esse objetivo, o uso de margens (frequentemente chamadas de "zonas silenciosas") melhora a legibilidade do código QR e garante que os dispositivos de leitura reconheçam o código corretamente em layouts exclusivos. Ajustes específicos na largura, altura e escala geral influenciam diretamente a proporção final de saída e a apresentação visual.

Este guia demonstra como usar margens para redimensionar e enquadrar seu código QR de forma eficaz com o IronQR, garantindo um ajuste perfeito para qualquer layout profissional.

Adicionando margens ao código QR

Estabelecer uma zona de silêncio adequada pode ser alcançado configurando a propriedade Margins dentro da classe QrStyleOptions. Essa propriedade aceita um único número inteiro que define uma borda em branco uniforme ao redor dos quatro lados do código QR.

Neste exemplo, definimos uma configuração de estilo com uma margem de 40 pixels, aplicamos essas configurações ao código QR durante o processo de renderização e, em seguida, salvamos a imagem resultante como um arquivo PNG.

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

QrStyleOptions styleOptions = new QrStyleOptions
{
    // Set all margins to 40px
    Margins = 40,

};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap using the style options
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qr-uniform-margins.png");
$vbLabelText   $csharpLabel

Saída

Código QR da Zona de Silêncio

Adicionando margens a lados específicos

Para layouts assimétricos, use as propriedades MarginTop, MarginBottom, MarginLeft e MarginRight dentro de QrStyleOptions. Isso proporciona um controle preciso sobre cada lado da zona silenciosa de forma independente.

Neste exemplo, são definidos valores personalizados para cada margem, juntamente com dimensões específicas e uma cor de fundo.

:path=/static-assets/qr/content-code-examples/how-to/add-specific-margins-qr-code.cs
using IronQr;
using IronSoftware.Drawing;

// Configure QR code styling with individual margins and background color
QrStyleOptions combinedOptions = new QrStyleOptions
{
    Dimensions = 400,
    MarginTop = 50,
    MarginBottom = 50,
    MarginLeft = 20,
    MarginRight = 20,
    BackgroundColor = IronSoftware.Drawing.Color.LightYellow,
};

string url = "https://ironsoftware.com/";

// Generate QR code from URL
QrCode qrCombined = QrWriter.Write(url);

// Apply styling options and export as bitmap
AnyBitmap qrCombinedImage = qrCombined.Save(combinedOptions);

// Save QR code to file
qrCombinedImage.SaveAs("qr-custom-margins.png");
$vbLabelText   $csharpLabel

Saída

Como você pode ver, as margens verticais são visivelmente maiores do que as margens horizontais.

Espaçamento seletivo de margem

Códigos QR gerados com margens adicionais

Código QR da Zona de Silêncio
Espaçamento seletivo de margem

Perguntas frequentes

O que são margens em um código QR?

As margens, também conhecidas como zonas de silêncio, são os espaços em branco ao redor de um código QR. Elas ajudam a melhorar a legibilidade e garantem que os dispositivos de leitura possam reconhecer o código facilmente.

Como as margens afetam a leitura de códigos QR?

As margens ajudam a garantir que os dispositivos de leitura possam ler corretamente o código QR, fornecendo uma zona de segurança que impede que elementos visuais próximos interfiram na legibilidade do código.

Como posso adicionar margens a um código QR em C#?

É possível adicionar margens a um código QR em C# usando a biblioteca IronQR. Ao configurar a propriedade `Margins` dentro da classe `QrStyleOptions`, você pode definir uma borda em branco uniforme ao redor do código QR.

Posso aplicar margens diferentes a cada lado de um código QR?

Sim, com o IronQR, você pode usar propriedades como `MarginTop`, `MarginBottom`, `MarginLeft` e `MarginRight` para aplicar margens diferentes a cada lado do código QR em layouts assimétricos.

Qual é a finalidade da classe `QrStyleOptions` no IronQR?

A classe `QrStyleOptions` no IronQR permite personalizar a aparência do seu código QR, incluindo a definição de margens, dimensões e outras opções de estilo para um layout profissional.

Como faço para salvar um código QR com margens adicionais como uma imagem?

Após configurar seu código QR com as margens desejadas usando o IronQR, você pode renderizá-lo e salvá-lo como um arquivo de imagem, como PNG, para uso externo.

Por que devo usar o IronQR para adicionar margens ao meu código QR?

IronQR oferece uma maneira simples e eficiente de personalizar as margens do código QR e outras opções de estilo em C#, garantindo um ajuste perfeito para qualquer layout profissional ou personalizado.

É possível definir uma cor de fundo para códigos QR no IronQR?

Sim, o IronQR permite definir uma cor de fundo para os códigos QR, melhorando o apelo visual e mantendo a legibilidade.

Em que tipos de arquivo posso salvar códigos QR usando o IronQR?

Com o IronQR, você pode salvar códigos QR em vários tipos de arquivo de imagem, como PNG, para uso versátil em diferentes aplicativos e plataformas.

Ahmad Sohail
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 61,359 | Versão: 2026.3 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.