Como Carimbar QR Codes em Páginas de PDF

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

Incorpora QR codes diretamente em seus documentos PDF para marcar páginas instantaneamente ou adicionar informações dinâmicas como URLs, IDs de rastreamento ou assinaturas digitais.

Adicionar um QR code a um PDF existente é um requisito comum em fluxos de trabalho de documentos. Faturas em PDFs podem conter um QR code ligando a um portal de pagamento. Registros governamentais podem incorporar um código de verificação. Ingressos de eventos podem incluir um ID escaneável sem reestruturar o layout inteiro do documento. IronQR torna isso simples: gere um código QR com QrWriter.Write e insira-o em qualquer página, em qualquer posição, com uma única chamada para DrawBitmap.

Este guia demonstra como incorporar QR codes em arquivos PDF existentes usando a biblioteca IronQR. Desenvolvedores que ainda não geraram um código QR devem começar com o guia Criar Código QR como Imagem primeiro.

Início Rápido: Carimbar um QR Code em um PDF

Gere um QR code e carimbe-o em uma página PDF existente em uma posição específica.

  1. Instale IronQR com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronQR
  2. Copie e execute este trecho de código.

    var qrBitmap = QrWriter.Write("https://example.com").Save();
    var pdf = PdfDocument.FromFile("document.pdf");
    pdf.Pages[0].DrawBitmap(qrBitmap, 505, 20, 70, 70);
    pdf.SaveAs("stamped.pdf");
  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

Carimbando um QR Code em uma Página de PDF

Para incorporar um código QR em um PDF existente, gere o código QR com QrWriter.Write e salve-o em um AnyBitmap com Save(). Carregue o PDF de destino com PdfDocument.FromFile e, em seguida, use DrawBitmap para posicionar o código QR em coordenadas precisas. Os valores x e y estão em pontos PDF (uma página A4 tem 595 × 842 pts), e desiredWidth e desiredHeight controlam o tamanho da impressão.

Entrada

O código QR abaixo codifica https://ironsoftware.com e será impresso no PDF.

Codificação de bitmap de código QR https://ironsoftware.com
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

// Generate QR code bitmap
AnyBitmap qrBitmap = QrWriter.Write("hello world").Save();

// Load the existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stamp the QR code at the top-right corner of page 1
// A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70);

pdf.SaveAs("sample.pdf");
Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

' Generate QR code bitmap
Dim qrBitmap As AnyBitmap = QrWriter.Write("hello world").Save()

' Load the existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Stamp the QR code at the top-right corner of page 1
' A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70)

pdf.SaveAs("sample.pdf")
$vbLabelText   $csharpLabel

O PDF modificado é salvo com SaveAs. Para evitar sobrescrever a fonte, passe um caminho de saída diferente.

Saída

O código QR é estampado no canto superior direito da página 1 nas coordenadas (505, 20) com um tamanho de 70 × 70 pontos PDF.


Controlando a Posição e o Número da Página

Os parâmetros x e y estão em pontos PDF medidos a partir do canto superior esquerdo da página. Aumentar x move o selo para a direita; Aumentar y o move para baixo. O parâmetro pageIndex começa em zero, portanto pageIndex: 0 tem como alvo a primeira página.

O exemplo a seguir carimba dois códigos QR em páginas diferentes — um link de verificação no canto superior direito da página 1 e um link de suporte no canto inferior esquerdo da página 2:

Entrada

Os dois códigos QR abaixo codificam os URLs de verificação e suporte que serão estampados em páginas separadas.

QR code encoding https://ironsoftware.com/verify
QR code encoding https://ironsoftware.com/support
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf-positions.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

PdfDocument pdf = PdfDocument.FromFile("document.pdf");

// Page 1: stamp a verification QR at the top-right corner
AnyBitmap qrVerify = QrWriter.Write("https://ironsoftware.com/verify").Save();
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70);

// Page 2: stamp a support QR at the bottom-left corner
AnyBitmap qrSupport = QrWriter.Write("https://ironsoftware.com/support").Save();
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70);

pdf.SaveAs("document.pdf");
Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")

' Page 1: stamp a verification QR at the top-right corner
Dim qrVerify As AnyBitmap = QrWriter.Write("https://ironsoftware.com/verify").Save()
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70)

' Page 2: stamp a support QR at the bottom-left corner
Dim qrSupport As AnyBitmap = QrWriter.Write("https://ironsoftware.com/support").Save()
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70)

pdf.SaveAs("document.pdf")
$vbLabelText   $csharpLabel

ObservePontos PDF são a unidade de medida para coordenadas em uma página PDF. Uma página A4 tem 595 pts de largura e 842 pts de altura, com (0, 0) no canto superior esquerdo. Para colocar um código QR de 70 pts com uma margem de 20 pts a partir da borda superior direita, subtraia o tamanho do QR e a margem da largura da página: x = 595 − 70 − 20 = 505, e mantenha y = 20 para ficar próximo do topo. Para o canto inferior esquerdo, x = 20 e subtraia da altura da página: y = 842 − 70 − 20 = 752.

Saída

Cada código QR é colocado em seu respectivo canto — verificação no canto superior direito da página 1, suporte no canto inferior esquerdo da página 2.


Casos de uso

  • Link para pagamento de faturas: Codifique um URL de portal de pagamento e carimbe-o no canto superior direito da página 1 para que os clientes possam escanear e pagar instantaneamente.
  • Verificação de documentos: Codifique um ID de registro ou hash e carimbe-o na parte inferior de cada página para permitir que os destinatários verifiquem a autenticidade.
  • Ingressos para eventos: Codifique um ID de participante ou referência de reserva e carimbe-o no centro da página 1 para fácil escaneamento na entrada.
  • Etiquetas de produtos: Codifique um URL de produto ou número de série e carimbe-o no canto superior esquerdo ou inferior direito para consultas rápidas de inventário.
  • Registros legais: Codifique um número de processo ou referência de arquivamento e carimbe-o no rodapé de cada página para rastreabilidade.

Para maior controle sobre o código QR antes da impressão, como definir níveis de correção de erros ou ajustar o tamanho de saída , configure um objeto QrOptions e passe-o para QrWriter.Write antes de chamar StampToExistingPdfPage.

Para mais padrões de geração de código QR, explore o tutorial do Gerador de Código QR C# e o conjunto completo de recursos do IronQR.

Perguntas frequentes

O que é IronQR?

IronQR é uma biblioteca poderosa para gerar e manipular códigos QR em aplicações .NET, permitindo criar, personalizar e integrar códigos QR em vários formatos de documentos, incluindo PDFs.

Como posso incorporar um código QR em um PDF existente usando IronQR?

Você pode incorporar um código QR em um PDF existente usando o método QrWriter.Write do IronQR para gerar o código QR e então estampar em uma página de PDF em coordenadas específicas com a função StampToExistingPdfPage.

O que é a função StampToExistingPdfPage?

A função StampToExistingPdfPage no IronQR permite que você coloque com precisão um código QR em um local específico em uma página PDF existente, permitindo incluir marca d'água em documentos ou adicionar dados dinâmicos sem problemas.

IronQR pode ser usado para marcar documentos com marca d'água?

Sim, IronQR pode ser usado para marcar documentos com marca d'água estampando códigos QR em páginas de PDF. Este recurso pode ser utilizado para adicionar informações dinâmicas ou branding aos seus documentos.

Quais são as vantagens de usar IronQR para integrar códigos QR em PDFs?

IronQR oferece métodos fáceis de usar para gerar e estampar códigos QR em PDFs, permitindo controle preciso sobre o posicionamento e personalização do código QR, tornando-o ideal para adicionar conteúdo dinâmico a documentos.

É possível personalizar o código QR antes de incorporá-lo em um PDF?

Sim, com IronQR, você pode personalizar vários aspectos de um código QR, como tamanho, cor e nível de correção de erro, antes de estampar em uma página PDF.

IronQR suporta a geração de códigos QR dinâmicos para PDFs?

IronQR suporta a geração de códigos QR dinâmicos, permitindo que você crie códigos QR que podem ser estampados em documentos PDF com informações atualizadas, tornando-o adequado para cenários que exigem atualizações de dados em tempo real.

Qual linguagem de programação é necessária para usar IronQR para estampar códigos QR em PDFs?

IronQR é projetado para uso com C#, fornecendo uma biblioteca robusta para desenvolvedores integrarem funcionalidades de código QR em aplicações .NET, incluindo a estampagem de códigos QR em arquivos PDF.

Como eu especifico as coordenadas para o posicionamento do código QR em um PDF com IronQR?

No IronQR, você pode especificar as coordenadas exatas para o posicionamento do código QR em uma página PDF usando a função StampToExistingPdfPage, garantindo posicionamento preciso para seu código QR.

Curtis Chau
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 Baixar 67,270 | Versão: 2026.5 just released
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.