syncfusion-winui-barcode

バーコードの実装（SfBarcode）

Syncfusion WinUI Barcode コントロール（SfBarcode）は、機械で読み取り可能なバーコード形式でデータを生成して表示します。外観、テキスト表示、シンボル体系固有の設定を幅広くカスタマイズでき、一次元（線形）バーコードと二次元バーコードの両方をサポートしています。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• WinUI アプリケーションでバーコードまたは QR コードを生成する
• テキスト、数字、データを機械で読み取り可能な形式にエンコードする
• 商品コード、在庫ラベル、配送情報を表示する
• モバイルデバイス向けのスキャン可能なコード（QR、DataMatrix）を作成する
• バーコードの印刷機能を実装する
• バーコードの外観（色、回転、テキスト表示）をカスタマイズする
• 特定のデータ型に適したシンボル体系を選択する
• シンボル体系固有の設定（誤り訂正、エンコード、チェックサム）を構成する

コンポーネントの概要

主な機能：

• 15 種類のシンボル体系： 12 種類の一次元バーコード形式と 3 種類の二次元バーコード形式
• 柔軟なテキスト表示： 配置、間隔、表示の有無をカスタマイズ可能
• 外観のカスタマイズ： 色、バーの幅、回転角度
• シンボル体系の設定： 種類ごとの構成（チェックサム、エンコード、誤り訂正）
• XAML とコードビハインドのサポート： 宣言型およびプログラムによる実装

一般的なユースケース：

• 商品ラベル（UPC、EAN コード）
• 在庫管理（Code39、Code128）
• 配送ラベル（GS1-128、DataMatrix）
• URL、連絡先情報、Wi-Fi 認証情報用の QR コード
• ドキュメントの追跡（Code93、PDF417）
• 医療用ラベル（Code32 医薬品）

ドキュメントとナビゲーションガイド

はじめに

📄 参照先： references/getting-started.md

次のような場合に参照してください。

• Syncfusion.Barcode.WinUI NuGet パッケージをインストールする
• バーコードコントロールを使用する新しい WinUI プロジェクトをセットアップする
• 名前空間のインポートを追加する（XAML：using:Syncfusion.UI.Xaml.Barcode、C#：using Syncfusion.UI.Xaml.Barcode）
• 基本的な設定で最初のバーコードを作成する
• 最小限必要なコード（Value + Symbology）を理解する

取り上げるトピック：

• WinUI 3 デスクトップアプリケーションの作成
• NuGet パッケージのインストール
• XAML と C# での名前空間の構成
• 基本的な SfBarcode 宣言
• シンボル体系の設定（CodabarBarcode の例）
• 最初に動作するサンプル

シンボル体系の種類

📄 参照先： references/symbology-types.md

次のような場合に参照してください。

• データに適したバーコードの種類を選択する
• 一次元バーコードと二次元バーコードの違いを理解する
• 各シンボル体系でサポートされる文字を確認する
• 特定のバーコード種類（Codabar、Code39、Code128、QR、DataMatrix など）を実装する
• さまざまなデータ型（数字のみ、英数字、ASCII 全般、バイナリ）をエンコードする

対象となるシンボル体系：

• 一次元バーコード： Codabar、Code11、Code32、Code39、Code39Extended、Code93、Code93Extended、Code128A/B/C、UPC、GS1Code128
• 二次元バーコード： QRBarcode、DataMatrixBarcode、Pdf417Barcode
• 各種類の文字セット表
• 業界別のユースケース

テキストのカスタマイズ

📄 参照先： references/text-customization.md

次のような場合に参照してください。

• バーコードの下にエンコードされたテキストを表示または非表示にする
• バーコードとテキストの間隔を調整する
• テキストを水平方向に配置する（Left、Center、Right）
• テキストを垂直方向に配置する（Top、Bottom）
• ShowValue プロパティでテキストの表示を制御する

カスタマイズオプション：

• Value プロパティ（エンコードするテキスト）
• ShowValue（表示の切り替え）
• TextSpacing（バーとテキストの間隔）
• HorizontalTextAlignment
• VerticalTextAlignment

ビジュアルのカスタマイズ

📄 参照: references/visual-customization.md

次のような場合に使用します。

• バーコードの色（Background、Foreground）を変更する
• バーの幅の比率（Module プロパティ）を調整する
• QR コードと DataMatrix コードの自動サイズ調整を有効にする
• バーコードを回転する（0°、90°、180°、270°）
• 適切なコントラストでスキャナーの読み取りやすさを確保する

カスタマイズ機能：

• Background と Foreground の色
• 1D バーコードのモジュール幅
• 2D バーコード用の AutoModule
• BarcodeRotation 列挙型を使用した RotationAngle
• スキャナーのコントラストに関する考慮事項

シンボル体系固有の設定

📄 参照: references/symbology-settings.md

次のような場合に使用します。

• 1D バーコードのチェックサムオプションを設定する
• DataMatrix バーコードのエンコード形式を設定する
• DataMatrix のマトリックスサイズを選択する
• QR コードのバージョンと誤り訂正レベルを設定する
• QR コードの入力モードを設定する
• バーコードリーダー用の開始／停止シンボルを追加する

設定オプション：

• 1D 設定： EnableCheckSum、ShowCheckSum、EncodeStartStopSymbols
• DataMatrix： Encoding（ASCII/ASCIINumeric/Auto/Base256）、MatrixSize（30 種類以上のサイズオプション）
• QR コード： QRVersion（1～40 または Auto）、ErrorCorrectionLevel（Low/Medium/Quartile/High）、InputMode（Numeric/AlphaNumeric/Binary）

クイックスタート

最小限のバーコード実装

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);

URL 用 QR コード

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

よく使われるパターン

パターン 1：製品ラベルのバーコード（UPC）

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

パターン 2：在庫コード（チェックサム付き Code39）

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

パターン 3：配送ラベル（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>

パターン 4：縦向きラベル用の回転バーコード

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

パターン 5：誤り訂正付き QR コード

<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>

パターン 6：色をカスタマイズしたバーコード

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

主なプロパティ

コアプロパティ

プロパティ	型	説明
Value	string	バーコードにエンコードするテキスト／データ
Symbology	BarcodeBase	バーコードの種類（Codabar、QR、DataMatrix など）
ShowValue	bool	バーコードの下にエンコードしたテキストを表示します（既定値：true）
Module	double	1D バーコードのバー幅の比率
AutoModule	bool	コントロールのサイズに基づいて 2D バーコードを自動サイズ調整します
RotationAngle	BarcodeRotation	バーコードを回転します（Angle0/90/180/270）
Background	Brush	バーコードの背景色
Foreground	Brush	バーコードのバー／ドットの色
TextSpacing	double	バーコードとテキストの間隔
HorizontalTextAlignment	TextAlignment	テキストの水平方向の配置（Left/Center/Right）
VerticalTextAlignment	BarcodeTextAlignment	テキストの垂直方向の位置（Top/Bottom）

シンボル体系の選択ガイド

数字のみのデータの場合：

• Code11、Code32、UpcBarcode、Code128C

英数字データの場合：

• Code39、Code93、Code128A/B

ASCII 文字全般の場合：

• Code39Extended、Code93Extended

コンパクトな 2D コードの場合：

• QRBarcode（URL、テキスト）
• DataMatrixBarcode（小さなラベル）

大容量のデータの場合：

• Pdf417Barcode（ID、輸送）

国際製品の場合：

• UpcBarcode、GS1Code128Barcode

よくあるユースケース

ユースケース 1：製品パッケージ

小売製品向けの UPC バーコードを生成し、テキストを中央揃えで表示します。

用途： 製品ラベル、小売用パッケージ、値札の作成
シンボル体系： UpcBarcode
参考資料： getting-started.md、symbology-types.md

ユースケース 2：倉庫の在庫管理

英数字の識別子を使って、在庫追跡用の読み取り可能なコードを作成します。

用途： 資産追跡、倉庫管理、在庫管理
シンボル体系： Code39、Code128
参考資料： symbology-types.md、symbology-settings.md

ユースケース 3：モバイルスキャン用の QR コード

URL、連絡先情報、または Wi-Fi 認証情報の QR コードを生成します。

用途： マーケティング資料、名刺、製品認証
シンボル体系： QRBarcode
参考資料： symbology-types.md、symbology-settings.md

ユースケース 4：配送ラベル

配送や物流向けにコンパクトな DataMatrix コードを作成します。

用途： 荷物追跡、郵便サービス、物流
シンボル体系： DataMatrixBarcode、GS1Code128Barcode
参考資料： symbology-types.md、symbology-settings.md

ユースケース 5：医薬品ラベル

医薬品の包装や追跡用に Code32 バーコードを生成します。

用途： 医療、製薬業界、処方箋ラベル
シンボル体系： Code32Barcode
参考資料： symbology-types.md

ユースケース 6：文書管理

アーカイブおよび検索システム向けに、PDF417 で文書 ID をエンコードします。

用途： 文書追跡、アーカイブシステム、身分証明カード
シンボル体系： Pdf417Barcode
参考資料： symbology-types.md

追加リソース

• NuGet パッケージ： Syncfusion.Barcode.WinUI
• 名前空間： Syncfusion.UI.Xaml.Barcode
• 公式ドキュメント： https://help.syncfusion.com/winui/barcode/
• GitHub のサンプル： https://github.com/SyncfusionExamples/syncfusion-winui-barcode-examples