バージョン

PDF 417

PDF417 は、大容量の平面記号です。

xamBarcode XamPdf417Barcode 05.png

以下は XamPdf417Barcode 記号に固有なプロパティです。

エラー訂正レベル

PDF417 エラー訂正レベルは、以下のプロパティで計算されます。

  • UseMinimumErrorCorrectionLevel が True（デフォルト）に設定されており、現在のデータのコードワード番号の最小エラー訂正レベルが ErrorCorrectionLevel 値（デフォルトで Level0）の設定より高い場合、最小レベルがコントロールで使用されます。ErrorCorrectionLevel が計算された最小エラー訂正レベルより高いレベルに設定されている場合、設定された ErrorCorrectionLevel が優先されます。

EncodingMode

PDF417 のエンコーディング アルゴリズムは、コントロールの EncodingMode プロパティによって選択されます。プロパティが Undefined（デフォルト値）に設定されている場合、コントロールは最善にアルゴリズム（場合によっては複数のアルゴリズムの組み合わせ）を選択し、最もコンパクトな方法で Data 値をエンコードします。データに適さない EncodingMode が設定されている場合、エラー メッセージが表示されます。

XAML の場合:

<ig:XamPdf417Barcode x:Name="Barcode" Data="xamBarcode" EncodingMode="Numeric" />

Visual Basic の場合:

Dim Barcode As New XamPdf417Barcode()
Barcode.Data = "xamBarcode"
Barcode.EncodingMode = CompactionMode.Numeric

C# の場合:

XamPdf417Barcode Barcode = new XamPdf417Barcode();
Barcode.Data = "xamBarcode";
Barcode.EncodingMode = CompactionMode.Numeric;
barcode dataError.png

Rows、Columns および AspectRatio

PDF417 マトリックスは、以下の順序で検証される異なる基準で定義されます。

  1. Columns/Rows プロパティが設定されている場合、このコントロールは、データおよびエラー訂正コードワードがこのセル数でエンコードできるかどうかをチェックし、できない場合はエラーを表示します。PDF417 は最大で 928 コードワードおよび Columns と Rows の組み合わせをエンコードすることに注意してください。つまり、928 を超えるセルではエラーとなります。

  2. Columns および Rows プロパティが設定されていない場合、このコントロールは AspectRatio が指定されているかどうかをチェックし、これを使用して、 WidthToHeightRatio に基づいてマトリックス サイズを作成します。

  3. 上記のいずれもが設定されていない場合、このコントロールはデフォルトの -0.5 に最も近いアスペクト比でマトリックスに Data および Error Correction コードバードを収めるために列および行数の最善の組み合わせを選択します。

上記のプロパティの一部を明示的に設定した場合、定義されたマトリックスがデータに適さないことがあります。この場合、XamPdf417Barcode は対応するエラー メッセージを表示します。

XAML の場合:

<ig:XamPdf417Barcode x:Name="Barcode" Data="xamBarcode" Rows="3" Columns="3" />

Visual Basic の場合:

Dim Barcode As New XamPdf417Barcode()
Barcode.Data = "xamBarcode"
Barcode.Rows = 3
Barcode.Columns = 3

C# の場合:

XamPdf417Barcode Barcode = new XamPdf417Barcode();
Barcode.Data = "xamBarcode";
Barcode.Rows = 3;
Barcode.Columns = 3;
xamBarcode XamPdf417Barcode 04.png
Note

注: XamPdf417Barcode は ECI (Extended Channel Interpretation)、Structured Append モードおよび MacroPDF タイプをサポートしません。この機能は将来のバージョンで実装されます。

XAML コード宣言付きのサンプル画像:

XAML の場合:

<ig:XamPdf417Barcode x:Name="Barcode" Data="PDF 417" />

Visual Basic の場合:

Dim Barcode As New XamPdf417Barcode()
Barcode.Data = "PDF 417"

C# の場合:

XamPdf417Barcode Barcode = new XamPdf417Barcode();
Barcode.Data = "PDF 417";
xamBarcode XamPdf417Barcode 01.png
xamBarcode XamPdf417Barcode 06.png