syncfusion-maui-barcode-generator

.NET MAUI バーコードジェネレーターの実装

Syncfusion® .NET MAUI Barcode Generator（SfBarcodeGenerator）は、データを機械で読み取り可能な形式で生成し、表示するデータ視覚化コントロールです。さまざまなバーコードシンボル体系を使用してテキストをエンコードする包括的な方法を提供し、一次元（線形）バーコードと二次元（マトリックス）バーコードの両方に対応しています。

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

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

• バーコードを生成する：小売商品、在庫、配送ラベル、識別用
• QRコードを作成する：URL、連絡先情報、Wi-Fi 認証情報、決済システム用
• データを視覚的にエンコードする：スキャンアプリケーションで使用する機械読み取り可能な形式にする
• 複数のシンボル体系に対応する：単一のアプリケーションで商品コードやバッチ追跡などを扱う
• バーコードの外観をカスタマイズする：ブランドイメージや読み取りやすさの要件に合わせる
• バーコードを表示する：Windows、macOS、Android、iOS 向けの .NET MAUI アプリケーションで表示する
• スキャンソリューションを実装する：バーコードを生成して表示する必要がある場合
• Data Matrix コードを追加する：小型パッケージや高密度のデータエンコードに使用する

コンポーネントの概要

Barcode Generator コントロールでは、小売向け（UPC、EAN）、在庫管理向け（Code128、Code39）、物流向け（Codabar）、最新の二次元コード（QR Code、Data Matrix）など、さまざまな業界標準形式のバーコードを作成できます。外観、テキスト表示、バーコードのサイズを幅広くカスタマイズできます。

主な機能：

• 13 種類のバーコードシンボル体系 - 11 種類の一次元タイプと 2 種類の二次元タイプ
• 一次元バーコード - Code128、EAN8、EAN13、UPC-A、UPC-E、Code39、Code39 Extended、Code93、Codabar、および Code128 のバリエーション（A、B、C）
• 二次元バーコード - 誤り訂正機能付き QR Code、複数のエンコード方式に対応した Data Matrix
• 外観のカスタマイズ - 前景色と背景色、バー／ドットのサイズ、テキストのスタイル
• テキスト表示 - カスタムフォント、色、間隔、配置で入力値を表示
• 柔軟なサイズ設定 - 正確に制御できる Module プロパティと、最適な表示を実現する自動サイズ設定

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

はじめに

📄 参照： references/getting-started.md

Barcode Generator を初めてセットアップするときは、このリファレンスを使用してください。

• NuGet パッケージのインストール（Syncfusion.Maui.Barcode）
• MauiProgram.cs でのハンドラー登録
• 基本的なバーコードの初期化と名前空間のインポート
• 既定のシンボル体系（Code128）または QR Code の設定
• ShowText プロパティを使用した入力値の表示
• 複数の IDE でのセットアップ（Visual Studio、VS Code、JetBrains Rider）

一次元バーコード

📄 参照： references/one-dimensional-barcodes.md

線形／一次元バーコードを使用する場合は、このリファレンスを参照してください。

• Codabar - 図書館、血液銀行向け。数字と特殊文字に対応
• Code39 - オプションのチェックデジットに対応した英数字。自己検査機能付き
• Code39 Extended - 小文字を含む ASCII 全文字に対応
• Code93 - 密度を高めた拡張版 Code39
• Code128 - 高効率、ASCII 全文字に対応、文字セットを自動選択
• Code128A - 大文字、制御文字（ASCII 0-95）
• Code128B - 大文字と小文字、標準キーボード文字（ASCII 32-127）
• Code128C - 数値ペア（00-99）による高密度の数値エンコード
• UPC-A - 12 桁の小売商品コード（北米）
• UPC-E - 小型パッケージ向けのゼロ抑制 UPC
• EAN-13 - 13 桁の国際商品コード
• EAN-8 - 8 桁の短縮商品コード
• バーの幅を制御する Module プロパティ

二次元バーコード

📄 参照： references/two-dimensional-barcodes.md

二次元マトリックスバーコードを扱う場合は、このリファレンスを使用してください。

• QR Code - URL、テキスト、大容量データに対応する正方形グリッドのバーコード
  • 誤り訂正レベル（Low 7%、Medium 15%、Quartile 25%、High 30%、Auto）
  • 入力モード（Numeric、AlphaNumeric、Binary、Auto）
  • コードのバージョン（1～40。21×21から177×177モジュールまで拡大）
  • 誤り訂正による破損コードの読み取り
• Data Matrix - ラベルや小型パッケージ向けの長方形／正方形グリッド
  • データ型（Numeric、AlphaNumeric、Binary）
  • エンコード方式（Auto、ASCII、ASCIINumeric、Base256）
  • 英数字で最大2335文字、数字で最大3116文字を収容
• ドット／セルのサイズを調整するModuleプロパティ

カスタマイズとスタイル設定

📄 参照： references/customization.md

バーコードの外観をカスタマイズする場合は、このリファレンスを使用してください。

• テキストのカスタマイズ
  • ShowTextプロパティで入力値を表示
  • TextStyle（フォントファミリー、サイズ、色、斜体／太字などの属性）
  • TextSpacing（バーコードとテキストの間隔）
  • TextAlignment（Start、Center、End）
• バー／ドットのカスタマイズ
  • Moduleプロパティ（最小のバー線またはドットのサイズ）
  • ForegroundColor（バー／ドットの色）
  • BackgroundColor（バーコードの背景色）
  • 1Dバーコードと2Dバーコードでの動作の違い
  • Moduleが設定されていない場合の自動サイズ調整