Como Carimbar QR Codes em Páginas de PDF

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 alvo com PdfDocument.FromFile, depois use DrawBitmap para colocar o código QR em coordenadas precisas. Os valores de x e y estão em pontos PDF (uma página A4 é 595 × 842 pts), e desiredWidth e desiredHeight controlam o tamanho estampado.

Entrada

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

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

$vbLabelText   $csharpLabel

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

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 a estampa para a direita; aumentar y move-a para baixo. O parâmetro pageIndex é baseado em zero, então pageIndex: 0 aponta para 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.

Entrada da Página 1 — código QR para ironsoftware.com/verify

Entrada da Página 2 — código QR para 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");

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

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 mais controle sobre o código QR antes de estampar, como definir níveis de correção de erro 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.