1. IronBarcode
  2. Tutoriais
  3. .NET Criar código QR personalizado
Como personalizar e adicionar logotipos a códigos QR em C#

Como Personalizar e Adicionar Logotipos a Códigos QR em C#

Hairil Hashimi Bin Omar
Hairil Hashimi Bin Omar
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Personalize códigos QR em C# adicionando logotipos, alterando cores e incluindo anotações usando o método CreateQrCodeWithLogo e recursos de estilo do IronBarcode para criar códigos QR de marca e profissionais para aplicações de marketing e negócios.

Os códigos QR ganharam popularidade em relação aos códigos de barras tradicionais devido à sua maior capacidade de dados e facilidade de escaneamento. Eles são especialmente valorizados no marketing por sua capacidade de personalização, incluindo opções para adicionar logotipos, mudar cores e incorporar outros elementos de marca. Empresas modernas aproveitam códigos QR personalizados para várias campanhas de marketing e estratégias de engajamento com o cliente.

Para atender essa demanda, a IronBarcode oferece um conjunto de recursos para personalizar códigos QR. Os usuários podem criar códigos QR com logotipos, mudar esquemas de cores e adicionar anotações. Essas capacidades são alimentadas pelo IronDrawing, uma biblioteca gratuita e de código aberto. A biblioteca suporta múltiplos formatos de código de barras incluindo códigos QR padrão, Micro QR e os mais recentes formatos rMQR.

Início Rápido: Construa um Código QR Personalizado em Uma Linha

Comece instantaneamente criando um código QR com seu logotipo, cor personalizada e anotação—tudo com configuração mínima e apenas uma linha de código do IronBarcode. Perfeito para desenvolvedores que desejam branding profissional rapidamente.

  1. Instale IronBarcode com o Gerenciador de Pacotes NuGet

    PM > Install-Package BarCode

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

    IronBarCode.QRCodeWriter.CreateQrCodeWithLogo("https://example.com", new IronBarCode.QRCodeLogo("logo.png"), 300).ChangeBarCodeColor(IronSoftware.Drawing.Color.DeepSkyBlue).AddAnnotationTextAboveBarcode("Scan Me", new IronSoftware.Drawing.Font("Verdana",12), IronSoftware.Drawing.Color.White, 5).SaveAsPng("customQR.png");

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

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

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)
  1. Baixe a biblioteca C# para personalizar códigos QR
  2. Use `CreateQrCodeWithLogo` para criar um código QR com um logotipo
  3. Aplique cores personalizadas com `ChangeBarCodeColor`
  4. Adicione anotações usando `AddAnnotationTextAboveBarcode`
  5. Exiba o valor do código QR com `AddBarcodeValueTextBelowBarcode`

Como criar códigos QR com um logotipo?

É necessário um objeto QRCodeLogo para incorporar a imagem do logotipo ao gerar o código QR. The CreateQrCodeWithLogo method generates a QR code with a logo. Este método faz parte dos abrangentes recursos de geração de códigos QR do IronBarcode, que oferecem amplas opções de personalização para desenvolvedores.

:path=/static-assets/barcode/content-code-examples/how-to/customize-qr-code-style-logo.cs
using IronBarCode;
using IronSoftware.Drawing;

// Create QR code logo from file path
QRCodeLogo logo = new QRCodeLogo("ironbarcode_top.webp", 0, 0, 20f);

GeneratedBarcode QrCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250);

QrCodeWithLogo.SaveAsPng("QrCodeWLogo2.png");
$vbLabelText   $csharpLabel
Código QR com logotipo colorido em quadrado embutido no centro mostrando exemplo de integração de logotipo

Vamos examinar o código QR de saída gerado pelo código acima. O código QR apresenta um logotipo no centro com bordas arredondadas. A integração do logotipo mantém a escaneabilidade do código QR enquanto adiciona identidade de marca.

Quais parâmetros controlam a aparência do logotipo?

Para personalizar o logotipo, preencha campos específicos ao criar um novo objeto QRCodeLogo. Aqui estão os campos necessários:

  • Importing Image: Import images from AnyBitmap, Stream, Byte Array, relative filepath, or URI. Para resultados ideais, use imagens de alta resolução em formatos comuns como PNG, JPEG ou WebP.
  • Dimensões da Imagem: Especifique a largura e altura desejadas em pixels. Se a imagem for grande demais para que o código QR continue legível, uma exceção será lançada. Use 0 para determinar automaticamente o maior tamanho viável.
  • Cantos da Imagem: Defina o raio dos cantos arredondados. Use 0 para cantos quadrados. Cantos arredondados criam uma aparência mais profissional e melhor integração visual.

Como faço para exportar o código QR gerado?

Para exportar o código QR gerado, invoque um método de salvamento. As opções de exportação incluem arquivos de imagem, Streams, HTML e PDF. Saiba mais sobre exportação de códigos de barras em diferentes formatos em nosso guia abrangente. Para aplicativos web, você também pode exportar códigos de barras como HTML para incorporação direta em páginas da web.

Como posso mudar a cor do meu código QR?

Além de adicionar logotipos, o IronBarcode permite que os usuários personalizem códigos QR alterando suas cores. Com IronDrawing, os usuários podem definir cores usando valores RGB ou códigos de cor Hex e aplicá-los a códigos QR. Este recurso é particularmente útil para manter a consistência da marca em materiais de marketing. Vamos examinar um trecho de código demonstrando este recurso e o código QR resultante.

:path=/static-assets/barcode/content-code-examples/how-to/customize-qr-code-style-logo-color.cs
using IronBarCode;
using IronSoftware.Drawing;

// Create QR code logo from file path
QRCodeLogo logo = new QRCodeLogo("ironbarcode_top.webp", 0, 0, 20f);

IronSoftware.Drawing.Color ColorFromRgb = new IronSoftware.Drawing.Color(51, 51, 153);

GeneratedBarcode QrCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250);
GeneratedBarcode QrCodeWithLogoAndColor = QrCodeWithLogo.ChangeBarCodeColor(ColorFromRgb);
QrCodeWithLogoAndColor.SaveAsPng("ColorQrCodeWithLogo.png");
$vbLabelText   $csharpLabel
Código QR azul com logotipo colorido personalizado ao centro mostrando personalização bem-sucedida de cor e logotipo

Quais formatos de cor são suportados?

O código acima estende o exemplo anterior de criação de códigos QR com logotipos. It demonstrates changing QR code color using the ChangeBarCodeColor method, which takes an IronSoftware.Drawing.Color object as input. Crie este objeto usando valores RGB, códigos Hex ou enums predefinidos. Visite nosso exemplo de código 'Criar Cor' para saber mais. O recurso de personalização de cores funciona perfeitamente com todos os formatos de código de barras suportados.

Quando devo usar cores personalizadas?

Cores personalizadas são particularmente úteis para:

  • Consistência da marca: Combinar códigos QR com a identidade visual da sua empresa
  • Temas de campanhas: Criar códigos QR temáticos para campanhas e eventos especiais
  • Hierarquia visual: Usar cor para destacar códigos QR importantes em materiais impressos
  • Acessibilidade: Garantir contraste suficiente para melhor escaneamento em várias condições

Ao selecionar cores, mantenha um contraste adequado entre o padrão do código QR e o fundo para garantir um escaneamento confiável. Cores escuras em fundos claros geralmente funcionam melhor.

Como adiciono anotações aos códigos QR?

Outro aspecto importante de personalizar códigos QR é adicionar anotações dentro da imagem do código QR. Essas anotações podem ser o próprio valor do código de barras ou texto personalizado para fins promocionais. Anotações ajudam os usuários a entender o que o código QR contém antes de escanear, melhorando a experiência do usuário e as taxas de engajamento.

Vamos examinar a implementação desses métodos e a imagem resultante do código QR.

:path=/static-assets/barcode/content-code-examples/how-to/customize-qr-code-style-logo-color-annotation.cs
using IronBarCode;
using IronSoftware.Drawing;

// Create QR code logo from file path
QRCodeLogo logo = new QRCodeLogo("ironbarcode_top.webp", 0, 0, 20f);

// Define color from RGB
Color colorForBarcode = new Color(51, 51, 153);

GeneratedBarcode qrCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250);
GeneratedBarcode qrCodeWithLogoAndColor = qrCodeWithLogo.ChangeBarCodeColor(colorForBarcode);
GeneratedBarcode qrCodeWithAnnotation = qrCodeWithLogoAndColor.AddAnnotationTextAboveBarcode("IronBarcodeRocks!", 2).AddBarcodeValueTextBelowBarcode(2);
qrCodeWithAnnotation.SaveAsPng("QRCodeWithAnnotation.png");
$vbLabelText   $csharpLabel
Código QR com anotação do logotipo IronBarcode ao centro, demonstrando capacidades de personalização de marca

Quais métodos de anotação estão disponíveis?

O IronBarcode oferece métodos para definir a posição da anotação (acima ou abaixo do código QR), bem como sua família de fontes e cor. Os métodos disponíveis incluem:

  • AddAnnotationTextAboveBarcode: Adds annotation text above the QR code
  • AddAnnotationTextBelowBarcode: Adds annotation text below the QR code
  • AddBarcodeValueTextAboveBarcode: Adds barcode value text above the QR code
  • AddBarcodeValueTextBelowBarcode: Adds barcode value text below the QR code

Esses métodos podem ser encadeados juntos para múltiplas anotações. Para opções de estilo mais avançadas, consulte nosso guia abrangente de estilo de código de barras.

Como posso personalizar a aparência da anotação?

Todos os quatro métodos aceitam uma fonte personalizada como um objeto IronSoftware.Drawing.Font, cor como um objeto IronSoftware.Drawing.Color, e um número inteiro para especificar o espaço superior e inferior em pixels. Esses parâmetros são opcionais; se não especificados, fonte, cor e espaçamento padrão serão usados. O objeto Fonte suporta várias famílias de fontes, estilos (Negrito, Itálico, Regular) e tamanhos para atender aos requisitos da sua marca.

Por que usar anotações em códigos QR?

As anotações melhoram códigos QR ao:

  • Fornecer contexto: Rótulos como "Escaneie para Menu" ou "Visite nosso site" esclarecem o propósito
  • Melhorar o engajamento: Chamadas claras para ação aumentam as taxas de escaneamento
  • Construir confiança: Exibir a URL ou o nome da empresa ajuda os usuários a se sentirem seguros
  • Aumentando a acessibilidade: As anotações de texto ajudam os usuários a entender o conteúdo sem necessidade de escaneamento

IronBarcode é uma ferramenta ideal para criar e personalizar códigos QR. Além dos métodos diretos de personalização, IronBarcode usa o IronDrawing como uma biblioteca auxiliar para processamento de imagens, proporcionando mais estabilidade do que depender de bibliotecas externas. Para exemplos adicionais e técnicas avançadas, explore nosso tutorial do Gerador de Código QR em C# e a Referência da API para documentação completa de todos os métodos e propriedades disponíveis.

Perguntas frequentes

Como adiciono um logotipo a um código QR em C#?

Você pode adicionar um logotipo a um código QR usando o método `CreateQrCodeWithLogo` do IronBarcode. Basta criar um objeto `QRCodeLogo` com o caminho do seu arquivo de imagem e passá-lo para o método juntamente com os dados do seu código QR. O logotipo será incorporado no centro do código QR, mantendo a legibilidade.

Posso alterar as cores do meu código QR?

Sim, o IronBarcode oferece o método ChangeBarCodeColor que permite personalizar as cores do código QR. Você pode aplicar qualquer cor da paleta IronSoftware.Drawing.Color para combinar com a identidade da sua marca, garantindo que o código QR permaneça legível.

Como adiciono anotações de texto a um código QR?

O IronBarcode oferece métodos como AddAnnotationTextAboveBarcode e AddBarcodeValueTextBelowBarcode para adicionar anotações de texto. Você pode personalizar a fonte, o tamanho, a cor e o posicionamento do texto para criar rótulos informativos ou chamadas para ação em seus códigos QR.

Quais formatos de código de barras são suportados para personalização?

O IronBarcode oferece suporte à personalização para diversos formatos de código de barras, incluindo códigos QR padrão, códigos Micro QR e os mais recentes formatos rMQR. Cada formato pode ser personalizado com logotipos, cores e anotações para atender às suas necessidades específicas.

Posso criar um código QR personalizado com apenas uma linha de código?

Sim, o IronBarcode permite criar um código QR totalmente personalizado em uma única linha, encadeando métodos. Você pode combinar os métodos `CreateQrCodeWithLogo`, `ChangeBarCodeColor` e `AddAnnotationTextAboveBarcode` para gerar um código QR personalizado com logotipo, cores e texto, tudo de uma só vez.

Quais formatos de imagem posso usar para logotipos de código QR?

O recurso QRCodeLogo do IronBarcode suporta formatos de imagem comuns, como PNG, JPG e outros formatos padrão. A biblioteca processa e incorpora automaticamente a imagem do seu logotipo, mantendo a legibilidade ideal do código QR.

Como a integração do logotipo afeta a legibilidade do código QR?

O IronBarcode posiciona automaticamente os logotipos no centro dos códigos QR, com tamanho e espaçamento adequados para manter a legibilidade. A biblioteca garante que o logotipo não interfira com os recursos de correção de erros do código QR, mantendo-o legível por leitores de código QR padrão.

Hairil Hashimi Bin Omar
Hairil Hashimi Bin Omar
  Converse agora mesmo com a equipe de engenharia.
Engenheiro de Software
Como todo grande engenheiro, Hairil é um ávido aprendiz. Ele está aprimorando seus conhecimentos em C#, Python e Java, usando esse conhecimento para agregar valor aos membros da equipe da Iron Software. Hairil ingressou na equipe da Iron Software vindo da Universiti Teknologi MARA, na Malásia, onde se formou em ...
Leia mais
Pronto para começar?
Nuget Downloads 2,108,094 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package BarCode
executar um exemplo Veja seu fio se transformar em um código de barras.