Como Carimbar QR Codes em Páginas de PDF
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. A IronQR torna isso simples: gere um código QR com QrWriter.Write e carimbe-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 PDFGere um QR code e carimbe-o em uma página PDF existente em uma posição específica.
-
1Install IronQR with NuGet Package Manager
-
2Copie 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");C# -
3Implante 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)
- Baixe a biblioteca IronQR C# para carimbar QR codes em PDFs
- Gere um bitmap de QR code usando
QrWriter.Write().Save() - Carregue o PDF com
PdfDocument.FromFile() - Chame
DrawBitmap()com índice de página, coordenadas x/y e tamanho - Salve o PDF modificado com
SaveAs()
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 posicionar o código QR em coordenadas precisas. Os valores x e y estão em pontos PDF (uma página A4 são 595 × 842 pts), e desiredWidth e desiredHeight controlam o tamanho carimbado.
Entrada
O código QR abaixo codifica https://ironsoftware.com e será carimbado no PDF.
using IronQr;
// Generate the QR code
QrCode myQr = QrWriter.Write("hello world");
// Stamp the QR code at the top-right corner of page 1 (zero-based pageIndex)
// A4 page is 595 x 842 PDF points; x:505, y:20 places the QR near the top-right.
// The final parameter is the PDF password ("" for unencrypted files).
myQr.StampToExistingPdfPage("sample.pdf", 505, 20, 0, "");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 carimbo para a direita; aumentar y o move para baixo. O parâmetro pageIndex é baseado em zero, então pageIndex: 0 mira 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
using IronQr;
// Page 1: stamp a verification QR at the top-right corner (pageIndex 0)
QrCode qrVerify = QrWriter.Write("https://ironsoftware.com/verify");
qrVerify.StampToExistingPdfPage("document.pdf", 505, 20, 0, "");
// Page 2: stamp a support QR at the bottom-left corner (pageIndex 1)
QrCode qrSupport = QrWriter.Write("https://ironsoftware.com/support");
qrSupport.StampToExistingPdfPage("document.pdf", 20, 752, 1, "");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 mais controle sobre o código QR antes de carimbá-lo, como configurar 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.
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.
What should I do if I haven't generated a QR code yet?
If you haven't generated a QR code, start with the [Create QR Code as Image](/csharp/qr/how-to/create-qr-code-image/) guide, which will walk you through the steps to generate a QR code using IronQR.
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 bem estruturados e visualmente atraentes.
