Anpassen und Gestalten von Barcodes in C#35; for .NET mit IronBarcode

Wie kann ich die Größe eines Barcodes ändern?

Wann sollte ich die ResizeTo-Methode verwenden?

Die Größenanpassung eines Barcodes ist ein Aspekt der Anpassung, den Nutzer mit IronBarcode erreichen können. Um diese Funktion zu nutzen, rufen Sie einfach die Methode ResizeTo auf und geben Sie die neuen Breiten- und Höhenmaße in Pixel (px) für den Barcode ein. Diese Aktion löst eine verlustfreie Neudarstellung des Barcodes aus. Bei dieser Methode bleibt die Qualität des Barcodes erhalten, während seine Abmessungen angepasst werden. Sie eignet sich daher perfekt für Szenarien, in denen Barcodes in bestimmte Layouts oder Druckgrößen eingepasst werden müssen.

Hinweis:Werte, die zu klein sind, um den BarCode lesen zu können, werden ignoriert.

using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcode(string barcodeText, int newWidth, int newHeight)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode
                     .ResizeTo(newWidth, newHeight)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode.png");
    }

    // Example usage with different size requirements
    public static void ResizeForDifferentFormats()
    {
        var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128);

        // Resize for product label
        barcode.ResizeTo(200, 50).SaveAsImage("product_label.png");

        // Resize for shipping label
        barcode.ResizeTo(300, 75).SaveAsImage("shipping_label.png");

        // Resize for inventory tag
        barcode.ResizeTo(150, 40).SaveAsImage("inventory_tag.png");
    }
}

using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcode(string barcodeText, int newWidth, int newHeight)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode
                     .ResizeTo(newWidth, newHeight)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode.png");
    }

    // Example usage with different size requirements
    public static void ResizeForDifferentFormats()
    {
        var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128);

        // Resize for product label
        barcode.ResizeTo(200, 50).SaveAsImage("product_label.png");

        // Resize for shipping label
        barcode.ResizeTo(300, 75).SaveAsImage("shipping_label.png");

        // Resize for inventory tag
        barcode.ResizeTo(150, 40).SaveAsImage("inventory_tag.png");
    }
}

$vbLabelText   $csharpLabel

Die Methode ResizeTo kann auf dem GeneratedBarcode-Objekt aufgerufen werden. Wenn Sie mit verschiedenen Ausgabeformaten arbeiten, sollten Sie sich auch unsere Anleitung BarCode als PDF erstellen ansehen. Nachfolgend sehen Sie die Barcode-Bilder, die mit dem obigen Codeschnipsel erzeugt wurden.

Vor der Größenanpassung

Nach der Größenanpassung

Warum die ResizeToMil-Methode für 1D BarCodes verwenden?

Ein weiterer Aspekt der Größenanpassung verfügbar in IronBarcode ist die ResizeToMil-Methode. Im Gegensatz zur ResizeTo-Methode passt diese die folgenden Komponenten an:

• Barcode-Element: Die Breite des schmalsten Barcode-Elements, gemessen in Tausendstel Zoll (mil).
• Höhe: Die Höhe des Barcodes, gemessen in Zoll (der Standard ist 1 Zoll).
• Auflösung: Punkte pro Zoll (der Standard ist 96 DPI).

Diese Methode eignet sich besonders für 1D-Barcodes und wird häufig in industriellen Anwendungen eingesetzt, bei denen es auf präzise Messungen ankommt. Das mil-Messsystem ist ein Industriestandard, der eine gleichbleibende Lesbarkeit von Barcodes bei verschiedenen Scannern und Druckbedingungen gewährleistet.

using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcodeToMil(string barcodeText, int elementWidthMil, int heightInches, int dpi = 96)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode to mil
                     .ResizeToMil(elementWidthMil, heightInches, dpi)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode_mil.png");
    }

    // Example for different industrial standards
    public static void CreateIndustrialBarcodes()
    {
        // Standard retail barcode (10 mil width, 1 inch height)
        BarcodeWriter.CreateBarcode("RETAIL-001", BarcodeEncoding.Code128)
                     .ResizeToMil(10, 1, 300)
                     .SaveAsImage("retail_barcode.png");

        // High-density warehouse barcode (5 mil width, 0.5 inch height)
        BarcodeWriter.CreateBarcode("WAREHOUSE-002", BarcodeEncoding.Code128)
                     .ResizeToMil(5, 0.5f, 600)
                     .SaveAsImage("warehouse_barcode.png");

        // Large shipping barcode (15 mil width, 2 inch height)
        BarcodeWriter.CreateBarcode("SHIP-003", BarcodeEncoding.Code128)
                     .ResizeToMil(15, 2, 200)
                     .SaveAsImage("shipping_barcode.png");
    }
}

using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcodeToMil(string barcodeText, int elementWidthMil, int heightInches, int dpi = 96)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode to mil
                     .ResizeToMil(elementWidthMil, heightInches, dpi)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode_mil.png");
    }

    // Example for different industrial standards
    public static void CreateIndustrialBarcodes()
    {
        // Standard retail barcode (10 mil width, 1 inch height)
        BarcodeWriter.CreateBarcode("RETAIL-001", BarcodeEncoding.Code128)
                     .ResizeToMil(10, 1, 300)
                     .SaveAsImage("retail_barcode.png");

        // High-density warehouse barcode (5 mil width, 0.5 inch height)
        BarcodeWriter.CreateBarcode("WAREHOUSE-002", BarcodeEncoding.Code128)
                     .ResizeToMil(5, 0.5f, 600)
                     .SaveAsImage("warehouse_barcode.png");

        // Large shipping barcode (15 mil width, 2 inch height)
        BarcodeWriter.CreateBarcode("SHIP-003", BarcodeEncoding.Code128)
                     .ResizeToMil(15, 2, 200)
                     .SaveAsImage("shipping_barcode.png");
    }
}

$vbLabelText   $csharpLabel

Sie können diese Methode auch auf dem GeneratedBarcode-Objekt aufrufen. Weitere Informationen zum Einstellen der genauen Barcode-Abmessungen finden Sie in unserer Anleitung zum Einstellen von BarCode-Rändern. In der folgenden Abbildung sehen Sie die Auswirkungen der Anwendung der Methode ResizeToMil: Die Leerräume an den Rändern des Barcodes werden eliminiert, und sowohl das schmalste Element als auch die Höhe des Barcodes werden entsprechend den für die Methode angegebenen Parameterwerten angepasst.

Vor ResizeToMil

Nach ResizeToMil

Wie kann ich BarCodes und Hintergrundfarben ändern?

Eine der gefragtesten Funktionen zur Gestaltung von Barcodes ist die Möglichkeit, sowohl die Barcode- als auch die Hintergrundfarben zu ändern. Dank IronDrawing bietet IronBarcode diese Möglichkeit. Durch die Anwendung sowohl der Methoden ChangeBarCodeColor als auch ChangeBackgroundColor auf dem GeneratedBarcode-Objekt können Nutzer die Farben des Barcodes und dessen Hintergrund ändern. Diese Funktion ist besonders nützlich für Branding-Zwecke oder bei der Erstellung von thematischen Barcodes für besondere Veranstaltungen oder Produktlinien.

using IronBarCode;
using IronSoftware.Drawing; // Required for color manipulation

public class BarcodeColorChanger
{
    public static void ChangeBarcodeColors(string barcodeText, Color barcodeColor, Color backgroundColor)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Change the barcode color
        barcode.ChangeBarCodeColor(barcodeColor);

        // Change the background color
        barcode.ChangeBackgroundColor(backgroundColor);

        // Save the colored barcode
        barcode.SaveAsImage("colored_barcode.png");
    }

    // Example: Create branded barcodes with company colors
    public static void CreateBrandedBarcodes()
    {
        // Company brand colors example
        var barcode = BarcodeWriter.CreateBarcode("BRAND-2024", BarcodeEncoding.Code128);

        // Apply brand colors
        barcode.ChangeBarCodeColor(Color.FromHex("#1E3A8A")) // Company blue
               .ChangeBackgroundColor(Color.FromHex("#F3F4F6")) // Light gray background
               .SaveAsImage("branded_barcode.png");

        // Create seasonal variation
        var seasonalBarcode = BarcodeWriter.CreateBarcode("HOLIDAY-2024", BarcodeEncoding.Code128);
        seasonalBarcode.ChangeBarCodeColor(Color.DarkGreen)
                       .ChangeBackgroundColor(Color.LightYellow)
                       .SaveAsImage("seasonal_barcode.png");
    }
}

using IronBarCode;
using IronSoftware.Drawing; // Required for color manipulation

public class BarcodeColorChanger
{
    public static void ChangeBarcodeColors(string barcodeText, Color barcodeColor, Color backgroundColor)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Change the barcode color
        barcode.ChangeBarCodeColor(barcodeColor);

        // Change the background color
        barcode.ChangeBackgroundColor(backgroundColor);

        // Save the colored barcode
        barcode.SaveAsImage("colored_barcode.png");
    }

    // Example: Create branded barcodes with company colors
    public static void CreateBrandedBarcodes()
    {
        // Company brand colors example
        var barcode = BarcodeWriter.CreateBarcode("BRAND-2024", BarcodeEncoding.Code128);

        // Apply brand colors
        barcode.ChangeBarCodeColor(Color.FromHex("#1E3A8A")) // Company blue
               .ChangeBackgroundColor(Color.FromHex("#F3F4F6")) // Light gray background
               .SaveAsImage("branded_barcode.png");

        // Create seasonal variation
        var seasonalBarcode = BarcodeWriter.CreateBarcode("HOLIDAY-2024", BarcodeEncoding.Code128);
        seasonalBarcode.ChangeBarCodeColor(Color.DarkGreen)
                       .ChangeBackgroundColor(Color.LightYellow)
                       .SaveAsImage("seasonal_barcode.png");
    }
}

Bei der Arbeit mit farbigen BarCodes ist es wichtig, einen ausreichenden Kontrast zwischen dem Barcode und den Hintergrundfarben zu schaffen, um die Lesbarkeit zu gewährleisten. Weitere Gestaltungsmöglichkeiten für QR-Codes finden Sie in unserem Tutorial QR-Codes anpassen und gestalten.

Wie füge ich Anmerkungen zu einem BarCode hinzu?

IronBarcode bietet auch die Möglichkeit, Barcode-Anmerkungen hinzuzufügen und zu gestalten. Das Styling von Anmerkungen wird ebenfalls durch die Funktionen von IronDrawing unterstützt, einschließlich des Bearbeitens der Anmerkungsfarbe und Schriftarten. Anmerkungen sind unerlässlich, um neben dem maschinenlesbaren Barcode auch menschenlesbare Informationen bereitzustellen, was sie für die Bestandsverwaltung, Produktkennzeichnung und Versandanwendungen unabdingbar macht.

using IronBarCode;
using IronSoftware.Drawing; // Required for font and color manipulation

public class BarcodeAnnotator
{
    public static void AnnotateBarcode(string barcodeText, string annotationText, Font annotationFont, Color annotationColor, float annotationSpacing)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Add annotation above the barcode
        barcode.AddAnnotationTextAboveBarcode(annotationText, annotationFont, annotationColor, annotationSpacing);

        // Add barcode value text below the barcode
        barcode.AddBarcodeValueTextBelowBarcode(annotationFont, annotationColor, annotationSpacing);

        // Save the annotated barcode
        barcode.SaveAsImage("annotated_barcode.png");
    }

    // Example: Create product label with annotations
    public static void CreateProductLabel()
    {
        var productCode = "PRD-12345-XL";
        var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);

        // Define fonts for different purposes
        var titleFont = new Font("Arial", FontStyle.Bold, 14);
        var valueFont = new Font("Arial", FontStyle.Regular, 12);

        // Add product name above
        barcode.AddAnnotationTextAboveBarcode("Premium Widget XL", titleFont, Color.Black, 5);

        // Add product code below
        barcode.AddBarcodeValueTextBelowBarcode(valueFont, Color.DarkGray, 3);

        // Apply additional styling
        barcode.ResizeTo(250, 80)
               .SaveAsImage("product_label_annotated.png");
    }
}

using IronBarCode;
using IronSoftware.Drawing; // Required for font and color manipulation

public class BarcodeAnnotator
{
    public static void AnnotateBarcode(string barcodeText, string annotationText, Font annotationFont, Color annotationColor, float annotationSpacing)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Add annotation above the barcode
        barcode.AddAnnotationTextAboveBarcode(annotationText, annotationFont, annotationColor, annotationSpacing);

        // Add barcode value text below the barcode
        barcode.AddBarcodeValueTextBelowBarcode(annotationFont, annotationColor, annotationSpacing);

        // Save the annotated barcode
        barcode.SaveAsImage("annotated_barcode.png");
    }

    // Example: Create product label with annotations
    public static void CreateProductLabel()
    {
        var productCode = "PRD-12345-XL";
        var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);

        // Define fonts for different purposes
        var titleFont = new Font("Arial", FontStyle.Bold, 14);
        var valueFont = new Font("Arial", FontStyle.Regular, 12);

        // Add product name above
        barcode.AddAnnotationTextAboveBarcode("Premium Widget XL", titleFont, Color.Black, 5);

        // Add product code below
        barcode.AddBarcodeValueTextBelowBarcode(valueFont, Color.DarkGray, 3);

        // Apply additional styling
        barcode.ResizeTo(250, 80)
               .SaveAsImage("product_label_annotated.png");
    }
}

Als Erweiterung des vorherigen Code-Snippets instanzieren wir zwei neue Iron Software.Drawing.Font-Objekte, um als Schriftarten für Anmerkungen sowohl über als auch unter dem Barcode zu dienen. Nur die Schriftfamilie ist erforderlich, um die Schriftart zu instanziieren, obwohl Sie zusätzliche Eigenschaften wie Größe und Stil für mehr Kontrolle angeben können.

• AddAnnotationTextAboveBarcode: Fügt benutzerdefinierten Anmerkungstext oberhalb des Barcodes hinzu.
• AddBarcodeValueTextBelowBarcode: Fügt den Barcode-Wert unterhalb des Barcodes hinzu.

Diese beiden Methoden akzeptieren die gleichen Parameter: Die Iron Software.Drawing.Font-Objekte, ein Iron Software.Drawing.Color-Objekt und den Abstand zwischen Barcode und Text. Zusätzlich erfordert die Methode AddAnnotationTextAboveBarcode einen String für den Anmerkungstext, da sie benutzerdefinierten Text oberhalb des Barcodes hinzufügt.

IronBarcode bietet eine breite Palette von Anpassungsoptionen für die Gestaltung von Barcodes. Für Anwendungen, die Unicode-Unterstützung in Kommentaren benötigen, lesen Sie unseren Leitfaden zum Schreiben von Unicode BarCodes. Wenn Sie mehr über die Anpassung von QR-Codes erfahren möchten, lesen Sie "Anpassen und Hinzufügen von Logos zu QR-Codes". Um gestylte Barcodes in verschiedene Formate zu exportieren, lesen Sie unser Tutorial BarCode als HTML erstellen.