このトピックでは、主要機能、最小要件など、igQRCodeBarcode コントロールの概念的情報を提供します。
このトピックを理解するためには、以下の概念を理解しておく必要があります。
このトピックは、以下のセクションで構成されます。
igQRCodeBarcode コントロールは、Web アプリケーションで使用する QR (Quick Response) バーコード画像を生成します。以下のスクリーンショットは、http://www.infragistics.com データをエンコードした igQRCodeBarcode コントロールのサンプルを示します。
このコントロールは、業界標準エンコーディングに対応し、生成された QR バーコードのサイズ設定、配置、読みやすさの最適化を図るためのオプションがいくつかあります。
igQRCodeBarcode コントロールの QR コード固有の設定およびルック アンド フィール (背景色、境界線の色、太さ) は構成可能です。詳細は、主要な機能の概要表を参照してください。
以下の表で、igQRCodeBarcode コントロールの主な機能を簡単に説明しています。詳細は、igQRCodeBarcode の構成のトピック グループを参照してください。
| 機能 | 説明 | |
|---|---|---|
| サイズ調整、ストレッチ、塗りつぶし | 設定可能な寸法 |
width および height プロパティが igQRCodeBarcode コントロールに設定されていない場合、コンテナーのサイズ (定義されている場合) に基づきサイズが設定されます。高さと幅を設定すると、QR バーコード マトリックスが表示される長方形領域が作成されます。
|
| 設定可能な最小サイズ要素: | マトリックスの最小サイズ要素の幅によって、マトリックス自体のサイズが決まります。この幅は、コンテナー内の使用可能なスペースと、QR バーコードをデコードする技術 (携帯電話など) にも関係があります。 最小サイズ要素のサイズは、xDimension プロパティにより管理されます。 | |
| 構成可能なストレッチ | stretch は、コントロールのコンテナー内での QR バーコード マトリックスの水平・垂直方向の広がりを管理します。 | |
| 構成可能な塗りつぶし |
バーコード マトリックスから構成される各種のバーは、論理グリッド内で可視化されます。
igQRCodeBarcode コントロールの barsFillMode プロパティは、バーを含む論理グリッドがコントロールのサイズを塗りつぶす方法を定義します。デフォルトでは、グリッドは igQRCodeBarcode コントロールが使用できるスペースをすべて塗りつぶします。
|
|
| QR コード固有 | 構成可能なエラー修正レベル |
igQRCodeBarcode コントロールは、バーコードが損傷したり汚れた場合、エンコードされたデータを復元することができます。許容誤差は、errorCorrectionLevel プロパティを使用して管理します。
|
| 構成可能なサイズ バージョン |
igQRCodeBarcode コントロールでは、適切なサイズ バージョンを選択して、そのモジュールの数を指定できます。
プロパティの値は、組み込まれており、データに対応するための最小バージョン (未定義) から、177x177 モジュールのようにサイズの大きなバージョンまでさまざまなサイズがあります。
|
|
| 構成可能なエンコード モード |
igQRCodeBarcode コントロールは、data 文字のタイプに応じて、圧縮することで大量の文字をエンコードできます。JIS 漢字もサポートされます。その場合は、encodingMode プロパティの Kanji 値を使用します。
|
|
| 構成可能な Extended Channel Interpretation (ECI) 番号 |
igQRCodeBarcode コントロールは、既定の UTF-8 または ISO-8859-1 以外の文字セットのデータをエンコードできます。この機能は eciNumber プロパティにより管理します。
|
|
| 構成可能な FNC1 モード |
igQRCodeBarcode コントロールは、エンコードされたデータのさまざまな書式または FNC1 モード (AIM Inc.によって合意された特定の業種アプリケーションに従ってフォーマットされたデータを対象とした GS1 (GS1 一般仕様に基づく) モードおよび業種モード) をサポートします。
|
|
| 構成可能なアプリケーション インジケーター |
igQRCodeBarcode コントロールの FCN1 モードを Industry に設定すると、アプリケーション インジケーターのプロパティを使用して、AIM Inc.の関連仕様を識別することができます。
|
|
| ルック アンド フィール | 構成可能なバーコードのバーの色 | バーコードの色を設定できます。 |
| 構成可能な背景色 | バーコードのバーの背景領域の色を指定できます。 | |
| 構成可能な境界線の太さと色 | バーコードの境界線の太さと色をカスタマイズできます。 | |
コントロールを操作可能にするために必要な igQRCodeBarcode の最小構成では、サイズ (width および height) を指定し、data オプションに値を設定して、コントロールにデータを供給します。
注: エンコードするデータのタイプによっては、追加のエンコーディング ファイルを読み込み、
eciNumberを設定する必要があります (詳細は、文字エンコードの構成 (igQRCodeBarcode) を参照してください)。
width および height オプションが igQRCodeBarcode コントロールに設定されていない場合、コンテナーのサイズ (定義されている場合) に基づきサイズが設定されます。
デフォルトでは、コントロールを描画するのに利用できるスペースの縦横比が、その内容の縦横比と異なるときは、ネイティブな縦横比 (1:1) を保ちながら、指定先の寸法に収まるように、内容のサイズは変更されます (stretch プロパティのデフォルト値は uniform)。
バーコード マトリックスから構成される各種のバーは、論理グリッド内で可視化されます。デフォルトで、グリッドは igQRCodeBarcode コントロールで利用可能なすべてのスペースを塗りつぶします (barsFillMode = "fillSpace")。
デフォルトの構成では、損傷した記号の 15% をデータ復元レベルとして指定します (errorCorrectionLevel = "medium")。
QR コードのバーコード マトリックスのサイズ バージョンが明示的に設定されていない場合は、データを格納する最小サイズのバージョンが使用されます (sizeVersion = "undefined")。
エンコード ロジックが書き込まれているファイルのサイズを最小に抑えるために、以下の 2 つのプロパティのデフォルト値は、選択されたエンコード方式に応じて異なります。
encodingMode は Shift_JIS エンコードの場合、undefined、それ以外のエンコードの場合、byte で解決します。eciNumber は、ISO-8859-1 文字セットが読み込まれている場合この文字セットを表す「3」、それ以外の場合は UTF-8を表す「26」になります。このトピックの追加情報については、以下のトピックも合わせてご参照ください。
igQRCodeBarcode の追加: このトピック グループでは、igQRCodeBarcode コントロールを HTML ページと ASP.NET MVC アプリケーションに追加する方法を説明します。
igQRCodeBarcode の構成: このトピック グループでは、igQRCodeBarcode コントロールのディメンション、文字エンコード、QR コード固有の設定を構成する方法を説明します。
igQRCodeBarcode のスタイル設定: このトピックでは、igQRCodeBarcode コントロールのルック アンド フィール、バーコードの色、背景色、および境界線の色と太さを設定する方法を説明します。
アクセシビリティの遵守 (igQRCodeBarcode): このトピックは、igQRCodeBarcode コントロールのアクセシビリティ機能を説明し、バーコードを含むページのアクセシビリティ遵守を実現する方法を説明します。
既知の問題と制限 (igQRCodeBarcode): このトピックでは、igQRCodeBarcode コントロールの既知の問題と制限に関する情報を提供します。
jQuery および MVC API リファレンス リンク (igQRCodeBarcode): このトピックでは、igQRCodeBarcode コントロールと ASP.NET MVC ヘルパーに関する API 参照ドキュメントへのリンクを提供します。
このトピックについては、以下のサンプルも参照してください。
QR コード固有の設定の構成: このサンプルでは、QR コード固有の設定の構成について紹介します。
QR バーコードのサイズ設定: このサンプルは、igQRCodeBarcode コントロールのサイズ設定を構成する方法を紹介します。
色の構成: このサンプルは、バーコードで使用する色を構成して igQRCodeBarcode コントロールをスタイル設定する方法を紹介します。
オンラインで表示: GitHub