Jak nakładać kody kreskowe na dokumenty PDF za pomocą C

Jakie parametry wymaga StampToExistingPdfPage?

Fragment kodu wywołuje metodę StampToExistingPdfPage() z obiektem GeneratedBarcode do nałożenia obiektu na dokument PDF. Ta metoda zapewnia elastyczność przy zachowaniu prostoty. Poniżej znajdują się parametry metody:

• pdfFilePath: System.String reprezentujący ścieżkę do dokumentu PDF (względna lub absolutna).
• x: System.Int32 dla pozycji poziomej w pikselach od lewego brzegu.
• y: System.Int32 dla pozycji pionowej w pikselach od dolnego brzegu.
• pageNumber: System.Int32 wskazujący stronę (indeksowany od 1, pierwsza strona to 1).
• password: System.String dla PDF chronionych hasłem (opcjonalne).

Kiedy użyć StampToExistingPdfPage?

Uruchomienie fragmentu kodu nakłada GeneratedBarcode bezpośrednio do dokumentu PDF bez pośredniego zapisywania. Ta metoda jest odpowiednia w scenariuszach wymagających:

• Unikalnych kodów śledzenia na etykietach wysyłkowych lub dokumentach dostawy
• Numerów partii na raportach produkcyjnych
• Numerów kontrolnych dokumentów na formularzach prawnych lub regulacyjnych
• Kodów QR dla cyfrowej autoryzacji lub szybkiego dostępu

Bezpośrednie nakładanie oszczędza czas przetwarzania i eliminuje pliki tymczasowe. Aby uzyskać informacje na temat różnych typów kodów kreskowych, zapoznaj się z przewodnikiem obsługiwanych formatów kodów kreskowych.

Jakie parametry akceptuje StampToExistingPdfPages?

Poniżej znajdują się parametry metody:

• pdfFilePath: System.String reprezentujący ścieżkę do dokumentu PDF.
• x: System.Int32 dla pozycji poziomej w pikselach.
• y: System.Int32 dla pozycji pionowej w pikselach.
• pageNumbers: IEnumerable stron do nałożenia (indeksowany od 1).
• password: System.String dla PDF chronionych hasłem (opcjonalne).

Dlaczego używać StampToExistingPdfPages zamiast pętli?

Ta metoda zapewnia efektywne nakładanie kodów kreskowych na wiele stron bez ręcznej iteracji, poprawiając czytelność kodu i wydajność. Wewnętrzna implementacja optymalizuje przetwarzanie PDF, prowadząc do:

• Szybszego wykonania: PDF otwierany i przetwarzany raz, a nie wielokrotnie
• Mniejszego zużycia pamięci: Efektywne zarządzanie zasobami dla dużych plików PDF
• Prostszego kodu: Brak ręcznej obsługi pętli i błędów
• Operacje atomowe: Wszystkie strony nałożone w jednej operacji

Dostosowanie wyglądu kodu kreskowego przed nałożeniem

Przed nałożeniem swojego kodu kreskowego na PDF, dostosuj jego wygląd. IronBarcode offers extensive customization options:

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Code128, 250, 80);

// Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number");
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy");
myBarcode.SetMargins(10);
myBarcode.ChangeBarcodeForegroundColor(System.Drawing.Color.DarkBlue);

// Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x: 450, y: 700, pageNumber: 1);

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Code128, 250, 80);

// Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number");
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy");
myBarcode.SetMargins(10);
myBarcode.ChangeBarcodeForegroundColor(System.Drawing.Color.DarkBlue);

// Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x: 450, y: 700, pageNumber: 1);

Dim myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Code128, 250, 80)

' Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number")
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy")
myBarcode.SetMargins(10)
myBarcode.ChangeBarcodeForegroundColor(System.Drawing.Color.DarkBlue)

' Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x:=450, y:=700, pageNumber:=1)

Praca z różnymi typami kodów kreskowych

Różne scenariusze wymagają różnych typów kodów kreskowych. Kody QR nadają się do URL-i i dużych zbiorów danych, podczas gdy Code128 działa dla alfanumerycznych identyfikatorów. Learn more about creating QR codes or explore other formats:

// QR Code for contact information
var qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD\nFN:John Doe\nTEL:555-1234\nEND:VCARD", 
    BarcodeEncoding.QRCode, 150, 150);
qrCode.StampToExistingPdfPage("businesscard.pdf", x: 400, y: 50, pageNumber: 1);

// Data Matrix for product tracking
var dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100);
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x: 50, y: 750, pageNumber: 1);

// QR Code for contact information
var qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD\nFN:John Doe\nTEL:555-1234\nEND:VCARD", 
    BarcodeEncoding.QRCode, 150, 150);
qrCode.StampToExistingPdfPage("businesscard.pdf", x: 400, y: 50, pageNumber: 1);

// Data Matrix for product tracking
var dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100);
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x: 50, y: 750, pageNumber: 1);

' QR Code for contact information
Dim qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD" & vbLf & "FN:John Doe" & vbLf & "TEL:555-1234" & vbLf & "END:VCARD", 
    BarcodeEncoding.QRCode, 150, 150)
qrCode.StampToExistingPdfPage("businesscard.pdf", x:=400, y:=50, pageNumber:=1)

' Data Matrix for product tracking
Dim dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100)
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x:=50, y:=750, pageNumber:=1)

Obsługa błędów i najlepsze praktyki

Wprowadzić odpowiednią obsługę błędów podczas pracy z operacjami nakładania kodu na PDF:

try
{
    GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", 
        BarcodeEncoding.Code128, 200, 60);

    // Verify the PDF exists before attempting to stamp
    if (File.Exists("target.pdf"))
    {
        myBarcode.StampToExistingPdfPage("target.pdf", x: 100, y: 100, pageNumber: 1);
        Console.WriteLine("Barcode stamped successfully!");
    }
    else
    {
        Console.WriteLine("PDF file not found!");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error stamping barcode: {ex.Message}");
    // Log the error or handle it appropriately
}

try
{
    GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", 
        BarcodeEncoding.Code128, 200, 60);

    // Verify the PDF exists before attempting to stamp
    if (File.Exists("target.pdf"))
    {
        myBarcode.StampToExistingPdfPage("target.pdf", x: 100, y: 100, pageNumber: 1);
        Console.WriteLine("Barcode stamped successfully!");
    }
    else
    {
        Console.WriteLine("PDF file not found!");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error stamping barcode: {ex.Message}");
    // Log the error or handle it appropriately
}

Imports System
Imports System.IO

Try
    Dim myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", BarcodeEncoding.Code128, 200, 60)

    ' Verify the PDF exists before attempting to stamp
    If File.Exists("target.pdf") Then
        myBarcode.StampToExistingPdfPage("target.pdf", x:=100, y:=100, pageNumber:=1)
        Console.WriteLine("Barcode stamped successfully!")
    Else
        Console.WriteLine("PDF file not found!")
    End If
Catch ex As Exception
    Console.WriteLine($"Error stamping barcode: {ex.Message}")
    ' Log the error or handle it appropriately
End Try

Rozważania dotyczące wydajności

Podczas pracy z dużymi plikami PDF lub wieloma operacjami nakładania, rozważ te wskazówki:

1. Operacje wsadowe: Użyj StampToExistingPdfPages() zamiast pętli StampToExistingPdfPage()
2. Pamięć podręczna kodu kreskowego: Utwórz raz i ponownie użyj obiektu GeneratedBarcode
3. Obliczanie współrzędnych: Wstępnie obliczyć spójne współrzędne pozycji
4. Zarządzanie pamięcią: Przetwarzać bardzo duże pliki PDF w partiach

For advanced scenarios involving reading barcodes from PDFs after stamping, see our guide on reading barcodes from PDF documents.