1. IronBarcode
  2. Guides pratiques
  3. Personnaliser et styliser les codes-barres
Comment utiliser le suivi OcrProgress en C#

Personnaliser et styliser des BarCodes en C# ; pour .NET avec IronBarcode

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronBarcode permet aux développeurs de personnaliser les codes-barres en C# en changeant les couleurs, en redimensionnant les dimensions et en ajoutant des annotations, avec des appels de méthode simples comme ChangeBarCodeColor() et ResizeTo() pour un contrôle complet du style.

Au fil des ans, l'utilisation des BarCodes est devenue de plus en plus populaire et est utilisée dans un large éventail d'applications, qu'il s'agisse de stocker des données, des identifiants ou des URL de pages web. Dans certaines applications, les codes-barres sont rendus visibles sur les produits, ce qui entraîne une demande accrue d'options de style. Par conséquent, certains types de codes-barres ont développé des apparences uniques telles que PDF417, Aztec, IntelligentMail, MaxiCode, DataMatrix, et bien d'autres encore. Pour obtenir une liste complète des formats pris en charge, consultez notre documentation Formats de codes-barres pris en charge.

En outre, IronBarcode offre aux utilisateurs des options pour styliser davantage les codes-barres, y compris des aspects tels que barcode colors, barcode resize, et background colors. Ceci est rendu possible grâce à l'assistance de notre bibliothèque open-source, IronDrawing. Ces capacités de stylisation s'appuient sur les fonctionnalités complètes de génération de codes-barres d'IronBarcode.

Guide rapide : Personnaliser la couleur et l'arrière-plan du code-barres

Voici un exemple simple montrant comment les développeurs peuvent rapidement appliquer des couleurs personnalisées aux barres et à l'arrière-plan d'un code-barres à l'aide d'IronBarcode. Vous verrez à quel point il est facile de générer un code-barres stylé avec un seul appel enchaîné. Pour des exemples plus avancés, consultez notre tutoriel sur le générateur d'images de codes-barres C#.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronBarcode avec le gestionnaire de packages NuGet

    PM > Install-Package BarCode

  2. Copiez et exécutez cet extrait de code.

    IronBarCode.BarcodeWriter.CreateBarcode("HELLO123", IronBarCode.BarcodeEncoding.Code128)
    .ChangeBarCodeColor(IronSoftware.Drawing.Color.Blue)
    .ChangeBackgroundColor(IronSoftware.Drawing.Color.White)
    .SaveAsImage("styled.png");

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronBarcode dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour personnaliser et styliser les codes-barres.
  2. Utilisez la méthode ResizeTo pour déclencher un nouveau rendu sans perte.
  3. Utilisez la méthode ResizeToMil pour redimensionner l'élément de code-barres
  4. Modifiez les couleurs du code-barres et de son fond
  5. Ajoutez des annotations au-dessus et en dessous du code-barres

Comment redimensionner un BarCode?

Quand utiliser la méthode ResizeTo?

Redimensionner un code-barres est un aspect de la personnalisation que les utilisateurs peuvent réaliser avec IronBarcode. Pour utiliser cette fonctionnalité, appelez simplement la méthode ResizeTo et entrez les nouvelles mesures de largeur et de hauteur en pixels (px) pour le code-barres. Cette action déclenche un re-rendu sans perte du code-barres. Cette méthode conserve la qualité du code-barres tout en ajustant ses dimensions, ce qui la rend parfaite pour les scénarios dans lesquels vous devez adapter les codes-barres à des mises en page ou des tailles d'impression spécifiques.

Les valeurs trop petites pour que le code-barres soit lisible seront ignorées.

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");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

La méthode ResizeTo peut être invoquée sur l'objet GeneratedBarcode. Lorsque vous travaillez avec différents formats de sortie, vous pourriez également vouloir explorer notre guide Créer un BarCode en PDF. Ci-dessous se trouvent les images de BarCode générées par l'exécution de l'extrait de code ci-dessus.

Original barcode with standard dimensions before resize operation

Avant le redimensionnement

Resized barcode showing clear black and white vertical bars after dimension modification

Après redimensionnement

Pourquoi utiliser la méthode ResizeToMil pour les BarCodes 1D?

Un autre aspect du redimensionnement disponible dans IronBarcode est la méthode ResizeToMil. Contrairement à la méthode ResizeTo, celle-ci ajuste les composants suivants :

  • Élément du code-barres : La largeur de l'élément de code-barres le plus étroit, mesurée en millièmes de pouce (mil).
  • Hauteur : La hauteur du code-barres, mesurée en pouces (par défaut 1 pouce).
  • Résolution : Points par pouce (par défaut 96 DPI).

Cette méthode est particulièrement adaptée aux codes-barres 1D et est couramment utilisée dans les applications industrielles où des mesures précises sont essentielles. Le système de mesure BarCode est une norme industrielle qui garantit une lisibilité cohérente des codes-barres à travers différents scanners et conditions d'impression.

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");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Vous pouvez également appeler cette méthode sur l'objet GeneratedBarcode. Pour plus d'informations sur la définition de dimensions précises pour les codes-barres, consultez notre guide Définir les marges des codes-barres. Dans l'image ci-dessous, vous verrez les effets de l'application de la méthode ResizeToMil : les espaces blancs sur les bords du code-barres sont éliminés, et l'élément le plus étroit ainsi que la hauteur du code-barres sont ajustés en fonction des valeurs des paramètres fournis à la méthode.

Original barcode with standard dimensions before ResizeToMil method is applied

Avant ResizeToMil

Linear barcode showing result after ResizeToMil method application with vertical black and white bars

Après ResizeToMil

Comment puis-je changer les couleurs du BarCode et de l'arrière-plan?

Une des fonctionnalités les plus recherchées pour styliser les codes-barres est la capacité de changer à la fois la couleur du code-barres et celle de l'arrière-plan. Grâce à IronDrawing, IronBarcode offre cette capacité. En utilisant les méthodes ChangeBarCodeColor et ChangeBackgroundColor sur l'objet GeneratedBarcode, les utilisateurs peuvent modifier les couleurs du code-barres et de son fond. Cette fonctionnalité est particulièrement utile à des fins d'image de marque ou lors de la création de BarCode à thème pour des événements spéciaux ou des lignes de produits.

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");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Lorsque vous travaillez avec des BarCodes colorés, il est important de maintenir un contraste suffisant entre le code-barres et les couleurs d'arrière-plan pour garantir la lisibilité. Pour plus d'options de style spécifiques aux codes QR, consultez notre tutoriel Personnaliser et styliser les codes QR.

Code QR avec des couleurs d'arrière-plan vert et d'avant-plan beige personnalisées démontrant la personnalisation des couleurs des codes-barres

Comment ajouter des annotations à un BarCode?

IronBarcode offre également l'option d'ajouter et de styliser des annotations de code-barres. Le style pour les annotations est également assisté par les fonctionnalités de IronDrawing, y compris l'édition de la couleur de l'annotation et des polices. Les annotations sont essentielles pour fournir des informations lisibles par l'homme à côté du code-barres lisible par la machine, ce qui les rend cruciales pour la gestion des stocks, l'étiquetage des produits et les applications d'expédition.

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");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
Code QR sarcelle et beige généré par IronBarcode contenant l'URL de ironsoftware.com

En tant qu'extension de l'extrait de code précédent, nous instancions deux nouveaux objets Iron Software.Drawing.Font pour servir de polices pour les annotations à la fois au-dessus et en dessous du code-barres. Seule la Famille de polices est requise pour instancier la police, bien que vous puissiez spécifier des propriétés supplémentaires telles que la taille et le style pour plus de contrôle.

  • AddAnnotationTextAboveBarcode : Ajoute un texte d'annotation personnalisé au-dessus du code-barres.
  • AddBarcodeValueTextBelowBarcode : Ajoute la valeur du code-barres en dessous du code-barres.

Ces deux méthodes acceptent les mêmes paramètres : les objets Iron Software.Drawing.Font, un objet Iron Software.Drawing.Color, et l'espacement entre le code-barres et le texte. De plus, la méthode AddAnnotationTextAboveBarcode nécessite une chaîne pour le texte d'annotation, car elle ajoute un texte personnalisé au-dessus du code-barres.

IronBarcode offre un large éventail d'options de personnalisation pour styliser les codes-barres. Pour les applications nécessitant la prise en charge d'Unicode dans les annotations, consultez notre guide Écrire des codes-barres Unicode. Pour en savoir plus sur la personnalisation des codes QR, consultez "How to Customize and Add Logos to QR Codes". Pour exporter des codes-barres stylisés vers différents formats, explorez notre tutoriel Créer un BarCode en HTML.

Questions Fréquemment Posées

Comment changer la couleur d'un BarCode en C# ?

IronBarcode fournit la méthode ChangeBarCodeColor() pour personnaliser facilement les couleurs des codes-barres. Il suffit d'enchaîner cette méthode après avoir créé votre code-barres pour appliquer n'importe quelle couleur de la palette IronSoftware.Drawing.Color, ce qui permet un contrôle complet de l'apparence visuelle de vos codes-barres.

Quelle méthode dois-je utiliser pour redimensionner un BarCode sans perdre en qualité ?

Utilisez la méthode ResizeTo() d'IronBarcode pour redimensionner les codes-barres sans perte de qualité. Cette méthode déclenche un re-rendu sans perte du code-barres à la largeur et à la hauteur spécifiées en pixels, en conservant la clarté tout en ajustant les dimensions pour s'adapter à des mises en page spécifiques ou à des exigences d'impression.

Puis-je personnaliser la couleur d'arrière-plan de mes BarCodes ?

Oui, IronBarcode vous permet de personnaliser les arrière-plans des codes-barres à l'aide de la méthode ChangeBackgroundColor(). Cette fonction vous permet de définir n'importe quelle couleur d'arrière-plan à l'aide de la palette IronSoftware.Drawing.Color, ce qui permet une intégration transparente avec vos exigences en matière de conception.

Quels formats de BarCode prennent en charge des options de style uniques ?

IronBarcode prend en charge différents formats de codes-barres aux apparences uniques, notamment PDF417, Aztec, IntelligentMail, MaxiCode et DataMatrix. Chaque format possède ses propres caractéristiques visuelles tout en permettant une personnalisation supplémentaire grâce aux méthodes de stylisation d'IronBarcode.

Comment ajouter des annotations aux codes-barres ?

IronBarcode vous permet d'ajouter des annotations au-dessus et au-dessous des codes-barres, améliorant ainsi la lisibilité et fournissant un contexte supplémentaire. Cette fonctionnalité est particulièrement utile pour ajouter du texte lisible par l'homme, des codes produits ou d'autres informations d'identification à côté du code-barres.

Quelle est la différence entre les méthodes ResizeTo et ResizeToMil ?

IronBarcode propose deux méthodes de redimensionnement : ResizeTo() pour un redimensionnement basé sur les pixels avec un re-rendu sans perte, et ResizeToMil() pour redimensionner l'élément du code-barres en utilisant des mesures en millièmes. Les deux méthodes maintiennent la qualité tout en répondant à des exigences de mesure différentes.

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Comme tous les grands ingénieurs, Hairil est un apprenant avide. Il affine ses connaissances en C#, Python et Java, utilisant ces connaissances pour apporter de la valeur aux membres de l'équipe dans toute Iron Software. Hairil a rejoint l'équipe d'Iron Software depuis l'Université Teknologi MARA en Malaisie, ...
Lire la suite
Prêt à commencer?
Nuget Téléchargements 2,002,059 | Version : 2025.12 vient de sortir