Implementing Barcodes (SfBarcode)

The Syncfusion WinUI Barcode control (SfBarcode) generates and displays data in machine-readable barcode formats. It supports both one-dimensional (linear) and two-dimensional barcodes with extensive customization options for appearance, text display, and symbology-specific settings.

When to Use This Skill

Use this skill when you need to:

Generate barcodes or QR codes in WinUI applications
Encode text, numbers, or data into machine-readable formats
Display product codes, inventory labels, or shipping information
Create scannable codes for mobile devices (QR, DataMatrix)
Implement barcode printing functionality
Customize barcode appearance (colors, rotation, text display)
Choose appropriate symbology for specific data types
Configure symbology-specific settings (error correction, encoding, checksums)

Component Overview

Key Capabilities:

15 Symbology Types: 12 one-dimensional + 3 two-dimensional barcode formats
Flexible Text Display: Customizable alignment, spacing, and visibility
Visual Customization: Colors, bar widths, rotation angles
Symbology Settings: Type-specific configurations (checksums, encoding, error correction)
XAML and Code-Behind Support: Declarative and programmatic implementation

Common Use Cases:

Product labeling (UPC, EAN codes)
Inventory management (Code39, Code128)
Shipping labels (GS1-128, DataMatrix)
QR codes for URLs, contact info, Wi-Fi credentials
Document tracking (Code93, PDF417)
Healthcare labels (Code32 pharmaceuticals)

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

Use this when you need to:

Install the Syncfusion.Barcode.WinUI NuGet package
Set up a new WinUI project with barcode control
Add namespace imports (XAML: using:Syncfusion.UI.Xaml.Barcode, C#: using Syncfusion.UI.Xaml.Barcode)
Create your first barcode with basic configuration
Understand the minimal code required (Value + Symbology)

Topics Covered:

Creating WinUI 3 desktop application
NuGet package installation
Namespace configuration in XAML and C#
Basic SfBarcode declaration
Setting symbology (CodabarBarcode example)
Initial working example

Symbology Types

📄 Read: references/symbology-types.md

Use this when you need to:

Choose the correct barcode type for your data
Understand differences between 1D and 2D barcodes
Learn which characters each symbology supports
Implement specific barcode types (Codabar, Code39, Code128, QR, DataMatrix, etc.)
Encode different data types (numeric-only, alphanumeric, full ASCII, binary)

Covered Symbologies:

1D Barcodes: Codabar, Code11, Code32, Code39, Code39Extended, Code93, Code93Extended, Code128A/B/C, UPC, GS1Code128
2D Barcodes: QRBarcode, DataMatrixBarcode, Pdf417Barcode
Character set tables for each type
Industry-specific use cases

Text Customization

📄 Read: references/text-customization.md

Use this when you need to:

Show or hide the encoded text below the barcode
Adjust spacing between barcode and text
Align text horizontally (Left, Center, Right)
Align text vertically (Top, Bottom)
Control text visibility with ShowValue property

Customization Options:

Value property (encoded text)
ShowValue (display toggle)
TextSpacing (gap between bars and text)
HorizontalTextAlignment
VerticalTextAlignment

Visual Customization

📄 Read: references/visual-customization.md

Use this when you need to:

Change barcode colors (Background, Foreground)
Adjust bar width ratios (Module property)
Enable auto-sizing for QR and DataMatrix codes
Rotate barcodes (0°, 90°, 180°, 270°)
Ensure scanner readability with proper contrast

Customization Features:

Background and Foreground colors
Module width for 1D barcodes
AutoModule for 2D barcodes
RotationAngle with BarcodeRotation enum
Scanner contrast considerations

Symbology-Specific Settings

📄 Read: references/symbology-settings.md

Use this when you need to:

Configure checksum options for 1D barcodes
Set encoding format for DataMatrix barcodes
Choose matrix size for DataMatrix
Configure QR code version and error correction level
Set input mode for QR codes
Add start/stop symbols for barcode readers

Configuration Options:

1D Settings: EnableCheckSum, ShowCheckSum, EncodeStartStopSymbols
DataMatrix: Encoding (ASCII/ASCIINumeric/Auto/Base256), MatrixSize (30+ size options)
QR Code: QRVersion (1-40 or Auto), ErrorCorrectionLevel (Low/Medium/Quartile/High), InputMode (Numeric/AlphaNumeric/Binary)

Quick Start

Minimal Barcode Implementation

XAML:

<Page xmlns:syncfusion="using:Syncfusion.UI.Xaml.Barcode">
    <Grid>
        <syncfusion:SfBarcode x:Name="barcode" 
                               Value="48625310"
                               Height="150">
            <syncfusion:SfBarcode.Symbology>
                <syncfusion:CodabarBarcode />
            </syncfusion:SfBarcode.Symbology>
        </syncfusion:SfBarcode>
    </Grid>
</Page>

C#:

using Syncfusion.UI.Xaml.Barcode;

SfBarcode barcode = new SfBarcode();
barcode.Value = "48625310";
barcode.Height = 150;
barcode.Symbology = new CodabarBarcode();
Root_Grid.Children.Add(barcode);

QR Code for URL

<syncfusion:SfBarcode x:Name="qrCode" 
                       Value="http://www.syncfusion.com"
                       Height="200"
                       Width="200">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:QRBarcode />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Common Patterns

Pattern 1: Product Label Barcode (UPC)

<syncfusion:SfBarcode Value="012345678905" 
                       Height="150" 
                       Width="300"
                       HorizontalTextAlignment="Center">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:UpcBarcode />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Pattern 2: Inventory Code (Code39 with Checksum)

<syncfusion:SfBarcode Value="ITEM12345" Height="120">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:Code39Barcode EnableCheckSum="True" 
                                   ShowCheckSum="True" />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Pattern 3: Shipping Label (DataMatrix)

<syncfusion:SfBarcode Value="SHIP2024-A45678" 
                       Width="200" 
                       Height="200"
                       ShowValue="False"
                       AutoModule="True">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:DataMatrixBarcode Encoding="Auto" 
                                       MatrixSize="Auto" />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Pattern 4: Rotated Barcode for Vertical Labels

<syncfusion:SfBarcode Value="VERTICAL123" 
                       RotationAngle="Angle90"
                       Height="250" 
                       Width="150">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:Code128BBarcode />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Pattern 5: QR Code with Error Correction

<syncfusion:SfBarcode Value="https://example.com/product/12345" 
                       Width="250" 
                       Height="250"
                       ShowValue="False">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:QRBarcode ErrorCorrectionLevel="High" 
                               QRVersion="Auto" />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Pattern 6: Custom Colored Barcode

<syncfusion:SfBarcode Value="COLORED123" 
                       Background="LightYellow"
                       Foreground="DarkBlue"
                       Height="150">
    <syncfusion:SfBarcode.Symbology>
        <syncfusion:Code128CBarcode />
    </syncfusion:SfBarcode.Symbology>
</syncfusion:SfBarcode>

Key Properties

Core Properties

Property	Type	Description
Value	string	The text/data to encode in the barcode
Symbology	BarcodeBase	The barcode type (Codabar, QR, DataMatrix, etc.)
ShowValue	bool	Display encoded text below barcode (default: true)
Module	double	Bar width ratio for 1D barcodes
AutoModule	bool	Auto-size 2D barcodes based on control size
RotationAngle	BarcodeRotation	Rotate barcode (Angle0/90/180/270)
Background	Brush	Barcode background color
Foreground	Brush	Barcode bars/dots color
TextSpacing	double	Space between barcode and text
HorizontalTextAlignment	TextAlignment	Text horizontal alignment (Left/Center/Right)
VerticalTextAlignment	BarcodeTextAlignment	Text vertical position (Top/Bottom)

Symbology Selection Guide

For numeric-only data:

Code11, Code32, UpcBarcode, Code128C

For alphanumeric data:

Code39, Code93, Code128A/B

For full ASCII characters:

Code39Extended, Code93Extended

For compact 2D codes:

QRBarcode (URLs, text)
DataMatrixBarcode (small labels)

For high-capacity data:

Pdf417Barcode (IDs, transport)

For international products:

UpcBarcode, GS1Code128Barcode

Common Use Cases

Use Case 1: Product Packaging

Generate UPC barcodes for retail products with centered text display.

When: Creating product labels, retail packaging, price tags
Symbology: UpcBarcode
References: getting-started.md, symbology-types.md

Use Case 2: Warehouse Inventory

Create scannable codes for inventory tracking with alphanumeric identifiers.

When: Asset tracking, warehouse management, stock control
Symbology: Code39, Code128
References: symbology-types.md, symbology-settings.md

Use Case 3: QR Codes for Mobile Scanning

Generate QR codes for URLs, contact information, or Wi-Fi credentials.

When: Marketing materials, business cards, product authentication
Symbology: QRBarcode
References: symbology-types.md, symbology-settings.md

Use Case 4: Shipping Labels

Create compact DataMatrix codes for shipping and logistics.

When: Package tracking, postal services, logistics
Symbology: DataMatrixBarcode, GS1Code128Barcode
References: symbology-types.md, symbology-settings.md

Use Case 5: Pharmaceutical Labels

Generate Code32 barcodes for medication packaging and tracking.

When: Healthcare, pharmaceutical industry, prescription labels
Symbology: Code32Barcode
References: symbology-types.md

Use Case 6: Document Management

Encode document IDs with PDF417 for archiving and retrieval systems.

When: Document tracking, archival systems, identification cards
Symbology: Pdf417Barcode
References: symbology-types.md

Additional Resources

NuGet Package: Syncfusion.Barcode.WinUI
Namespace: Syncfusion.UI.Xaml.Barcode
Official Documentation: https://help.syncfusion.com/winui/barcode/
GitHub Examples: https://github.com/SyncfusionExamples/syncfusion-winui-barcode-examples

syncfusion-winui-barcode

Implementing Barcodes (SfBarcode)

When to Use This Skill

Component Overview

Documentation and Navigation Guide

Getting Started

Symbology Types

Text Customization

Visual Customization

Symbology-Specific Settings

Quick Start

Minimal Barcode Implementation

QR Code for URL

Common Patterns

Pattern 1: Product Label Barcode (UPC)

Pattern 2: Inventory Code (Code39 with Checksum)

Pattern 3: Shipping Label (DataMatrix)

Pattern 4: Rotated Barcode for Vertical Labels

Pattern 5: QR Code with Error Correction

Pattern 6: Custom Colored Barcode

Key Properties

Core Properties

Symbology Selection Guide

Common Use Cases

Use Case 1: Product Packaging

Use Case 2: Warehouse Inventory

Use Case 3: QR Codes for Mobile Scanning

Use Case 4: Shipping Labels

Use Case 5: Pharmaceutical Labels

Use Case 6: Document Management

Additional Resources