1. IronQR
  2. Poradniki
  3. Wprowadź kod QR do pliku PDF

Jak dodać kody QR do stron PDF

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

Osadzaj kody QR bezpośrednio w swoich dokumentach PDF, aby natychmiastowo znakować strony lub dodawać dynamiczne informacje, takie jak adresy URL, ID śledzenia lub podpisy cyfrowe.

Dodanie kodu QR do istniejącego pliku PDF jest częstym wymogiem w przepływach pracy z dokumentami. Faktury w formacie PDF mogą zawierać kod QR, który prowadzi do portalu płatności. Dokumenty rządowe mogą zawierać kod weryfikacyjny. Bilety na wydarzenia mogą zawierać zeskanowalny identyfikator bez konieczności restrukturyzacji całego układu dokumentu. IronQR sprawia, że to proste: wygeneruj kod QR za pomocą QrWriter.Write i umieść go na dowolnej stronie w dowolnym miejscu za pomocą pojedynczego wywołania DrawBitmap.

Ten przewodnik pokazuje, jak osadzić kody QR w istniejących plikach PDF za pomocą biblioteki IronQR. Deweloperzy, którzy jeszcze nie wygenerowali kodu QR, powinni najpierw rozpocząć od przewodnika Create QR Code as Image.

Szybki start: Dodanie kodu QR do pliku PDF

Wygeneruj kod QR i umieść go na istniejącej stronie PDF w określonym miejscu.

  1. Install IronQR with NuGet Package Manager

    PM > Install-Package IronQR

  2. Skopiuj i uruchom ten fragment kodu.

    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. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronQR w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Minimalny proces (5 kroków)

  1. Pobierz bibliotekę IronQR C#, aby dodawać kody QR do plików PDF
  2. Wygeneruj bitmapy kodu QR za pomocą QrWriter.Write().Save()
  3. Załaduj PDF za pomocą PdfDocument.FromFile()
  4. Wywołaj DrawBitmap() z indeksami strony, współrzędnymi x/y i rozmiarem
  5. Zapisz zmodyfikowany PDF za pomocą SaveAs()

Dodawanie kodu QR do strony PDF

Aby osadzić kod QR w istniejącym pliku PDF, wygeneruj kod QR za pomocą QrWriter.Write i zapisz go do AnyBitmap za pomocą Save(). Załaduj docelowy PDF za pomocą PdfDocument.FromFile, a następnie użyj DrawBitmap, aby umieścić kod QR na precyzyjnych współrzędnych. Wartości x i y są podane w punktach PDF (strona A4 ma 595 × 842 pts), a desiredWidth i desiredHeight kontrolują rozmiar nadruku.

Dane wejściowe

Kod QR poniżej koduje https://ironsoftware.com i zostanie umieszczony na PDF.

Bitmapa kodu QR koduje 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

Zmodyfikowany PDF jest zapisywany za pomocą SaveAs. Aby uniknąć nadpisania źródła, podaj inną ścieżkę wyjściową.

Wynik

Kod QR jest umieszczony w prawym górnym rogu strony 1 na współrzędnych (505, 20) z rozmiarem 70 × 70 punktów PDF.

Kontrola pozycji i numeru strony

Parametry x i y są podane w punktach PDF mierzonych od lewego górnego rogu strony. Zwiększenie x przesuwa nadruk w prawo; zwiększenie y przesuwa go w dół. Parametr pageIndex jest indeksowany od zera, więc pageIndex: 0 adresuje pierwszą stronę.

Poniższy przykład umieszcza dwa kody QR na różnych stronach — link weryfikacyjny w prawym górnym rogu strony 1 i link do wsparcia w lewym dolnym rogu strony 2:

Dane wejściowe

Dwa kody QR poniżej kodują adresy URL weryfikacji i wsparcia, które będą umieszczone na oddzielnych stronach.

QR code encoding https://ironsoftware.com/verify

Wejście strony 1 — kod QR dla ironsoftware.com/verify

QR code encoding https://ironsoftware.com/support

Wejście strony 2 — kod QR dla 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

Zwróć uwagęPunkty PDF są jednostką miary dla współrzędnych na stronie PDF. Strona A4 ma 595 pkt szerokości i 842 pkt wysokości, z (0, 0) w lewym górnym rogu. Aby umieścić kod QR 70 pkt z marginesem 20 pkt od prawej krawędzi góry, odejmij rozmiar kodu QR i margines od szerokości strony: x = 595 − 70 − 20 = 505, i utrzymaj y = 20 aby utrzymać się blisko góry. Dla lewego dolnego rogu, x = 20 i odejmij od wysokości strony: y = 842 − 70 − 20 = 752.

Wynik

Każdy kod QR jest umieszczony w odpowiednim rogu — weryfikacja w prawym górnym rogu strony 1, wsparcie w lewym dolnym rogu strony 2.

Przykłady zastosowań

  • Link do płatności faktury: Zakoduj URL portalu płatności i umieść go w prawym górnym rogu strony 1, aby klienci mogli natychmiastowo zeskanować i zapłacić.
  • Weryfikacja dokumentu: Zakoduj ID rekordu lub skrót i umieść go na dole każdej strony, aby umożliwić odbiorcom weryfikację autentyczności.
  • Bilety na wydarzenia: Zakoduj ID uczestnika lub referencję rezerwacji i umieść je na środku strony 1, aby łatwo zeskanować przy wejściu.
  • Etykiety produktów: Zakoduj URL produktu lub numer seryjny i umieść je w lewym górnym lub prawym dolnym rogu, aby szybko wyszukać w inwentarzu.
  • Akta prawne: Zakoduj numer sprawy lub referencję wpłynięcia i umieść je w stopce każdej strony dla śledzenia.

Aby uzyskać większą kontrolę nad kodem QR przed umieszczeniem, na przykład ustawienie poziomu korekcji błędów lub dostosowanie rozmiaru wyjściowego, skonfiguruj obiekt QrOptions i przekaż go do QrWriter.Write przed wywołaniem StampToExistingPdfPage.

Dla więcej wzorców generowania kodów QR, zobacz tutorial C# QR Code Generator oraz pełen zestaw funkcji IronQR.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 63,676 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronQR
uruchom próbkę obserwuj, jak Twój URL staje się kodem QR.