> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BarcodeParams オブジェクト（IBarcodeParams インターフェイス）

> ABBYY FineReader Engine API の BarcodeParams オブジェクト（IBarcodeParams インターフェイス）— バーコードブロック認識のパラメーターを調整します。各バーコードブロックは独自の子 BarcodeParams を持ち、PageAnalysisParams のサブオブジェクトとしても渡されます。

このオブジェクトでは、バーコードブロック認識のパラメーターを調整できます。レイアウト内の各バーコードブロックには、それぞれ BarcodeParams 型の子オブジェクトがあります。また、このオブジェクトは [PageAnalysisParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageanalysisparams) オブジェクトのサブオブジェクトとして、ABBYY FineReader Engine のレイアウト解析・認識関数に渡されます。認識関数では、これらの関数に渡された PageAnalysisParams オブジェクトのサブオブジェクトで指定された値ではなく、バーコードブロックの BarcodeParams 型の子オブジェクトで指定されたバーコード認識パラメーターが使用されます。

レイアウト解析中にバーコードブロックが作成されると、その BarcodeParams 型の子オブジェクトのプロパティは、レイアウト解析関数に渡された BarcodeParams オブジェクトのプロパティ値で初期化されます。[Layout](/ja/fine-reader/engine/api-reference/layout-related-objects/layoutblocks) オブジェクトの [AddNew](/ja/fine-reader/engine/api-reference/layout-related-objects/layoutblocks/addnew-method) メソッドを使用して作成されたバーコードブロックのプロパティには、適切な既定値が設定されます。既定値については、各プロパティの説明を参照してください。

バーコード処理に関する有用な推奨事項については、[バーコードの認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-barcodes) を参照してください。

BarcodeParams オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドが使用されます。

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)、および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<div id="properties">
  ## プロパティ
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>名前</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>型</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>Application</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          <strong>Engine</strong> オブジェクトを返します。
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>主な設定</em>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="enablebarcodescheck" />

          <strong>EnableBarcodesCheck</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          バーコード確認分類器を使用できるかどうかを指定します。この分類器は、画像上にバーコードが存在するかどうかを検証します。
        </p>

        <p>このプロパティは郵便バーコードには対応していません。</p>
        <p>このプロパティのデフォルト値は TRUE です。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="orientation" />

          <strong>Orientation</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              int
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティの値は、バーコードの向きの種類を示す{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/barcodeorientationenum">
              BarcodeOrientationEnum
            </a>
          </strong>

          {" "}

          列挙定数の OR 結合です。たとえば、BO\_Left\_To\_Right |
          BO\_Down\_To\_Top に設定した場合、ABBYY FineReader Engine はバーコードブロックが左から右または下から上のいずれかの向きであると見なし、その他の向きはすべて無視します。
        </p>

        <p>
          デフォルトでは、このプロパティは BO\_Autodetect に設定されています。この場合、ABBYY FineReader Engine がバーコードの向きを自動的に検出します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="type" />

          <strong>型</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              int
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティの値は、バーコードの種類を示す{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/barcodetypeenum">
              BarcodeTypeEnum
            </a>
          </strong>

          {" "}

          列挙定数の OR 結合です。たとえば、BT\_EAN13 | BT\_EAN8 に設定した場合、ABBYY FineReader Engine は{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#ean813">
            EAN 13 または EAN 8
          </a>

          {" "}

          規格でバーコードブロックの認識を試み、その他の規格はすべて無視します。
        </p>

        <p>
          デフォルトでは、このプロパティは BT\_Autodetect に設定されています。この場合、ABBYY FineReader Engine がバーコードの種類を自動的に検出します。
        </p>

        <Note>
          デフォルト値では、サポートされているすべての種類のバーコードを検出できます。ただし、画像に確実に含まれると分かっている場合を除き、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#iata">
            IATA 2 of 5
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#interleaved2_5">
            Interleaved 2 of 5
          </a>

          、および{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#matrix2_5">
            Matrix 2 of 5
          </a>

          {" "}

          のバーコード種類は除外することをお勧めします。これらの種類のバーコードにはチェックサムがないため、実際にはバーコードが含まれていない画像領域で誤検出される可能性があります。
        </Note>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>特定のバーコード種類の設定</em>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="codepage" />

          <strong>CodePage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/codepageenum">
              CodePageEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティは、バーコード仕様に準拠していない{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#pdf_417">
            PDF417
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#aztec">
            Aztec
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#datamatrix">
            Data Matrix
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#qrcode">
            QR Code
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#maxicode">
            MaxiCode
          </a>

          {" "}

          バーコードの認識に使用します。バーコード仕様に準拠して作成されたバーコードには使用しないでください。バーコードプリンターによっては、仕様で要求されているコードページとは異なるコードページを使用する場合があります。その場合は、このプロパティを使用して、バーコードの作成に使用されたコードページを指定してください。ほとんどの場合、バーコードプリンターが動作していたオペレーティングシステムのコードページが該当します。
        </p>

        <Note>
          仕様で要求されているコードページは以下のとおりです：
        </Note>

        <ul>
          <li>
            PDF417 の場合 — DOS United States (437) (

            <a href="/ja/fine-reader/engine/api-reference/enumerations/codepageenum#cp_us_msdos">
              CP\_US\_MSDOS
            </a>

            )
          </li>

          <li>
            Aztec、DataMatrix、QR Code、MaxiCode の場合 — ISO Latin 1 (8859-1) (

            <a href="/ja/fine-reader/engine/api-reference/enumerations/codepageenum#cp_latin_iso">
              CP\_Latin\_ISO
            </a>

            )
          </li>
        </ul>

        <p>
          このプロパティは、認識されたデータを Unicode 文字列に変換する際に使用されます。
        </p>

        <p>
          デフォルトでは、このプロパティはCP\_Nullに設定されており、仕様で要求されるコードページが使用されます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="containsbinarydata" />

          <strong>ContainsBinaryData</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティは、バイナリデータをエンコードする{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#pdf_417">
            PDF417
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#aztec">
            Aztec
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#datamatrix">
            Data Matrix
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#qrcode">
            QR Code
          </a>

          {" "}

          バーコードにのみ適用されます。このプロパティは、認識テキスト内でのバイナリデータの表現方法に影響します。
        </p>

        <p>
          このプロパティがTRUEの場合、バーコードにエンコードされたバイナリデータは、対応するバイトの16進数値のシーケンスとして保存されます。
          FALSEの場合、バイナリデータは{" "}
          <strong>CodePage</strong> プロパティで指定されたコードページを使用してUnicode文字列に変換されます。
        </p>

        <Note>
          バイナリデータに対応するバーコードシンボルは、{" "}

          <a href="/ja/fine-reader/engine/api-reference/text-related-objects/barcodesymbol#isbinarydata">
            IBarcodeSymbol::IsBinaryData
          </a>

          {" "}

          プロパティがTRUEに設定されています。
        </Note>

        <p>デフォルトでは、このプロパティの値はFALSEです。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="haschecksum" />

          <strong>HasChecksum</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          認識対象のバーコードを、同じ種類でチェックサムありのバーコードとして解釈するかどうかを指定します。このプロパティは、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#code_39">
            Code 39
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#interleaved2_5">
            Interleaved 2 of 5
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#codabar">
            Codabar
          </a>

          、および{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#matrix2_5">
            Matrix 2 of 5
          </a>

          タイプのバーコードにのみ使用できます。
        </p>

        <Note>
          Codabarにはチェックデジットがありませんが、ABBYY FineReader EngineはModulo 16に基づくチェックデジット計算アルゴリズムを使用します。チェックデジットの計算方法は次のとおりです。各Codabar文字には値が割り当てられています。スタート文字とストップ文字を含むすべての文字値の合計を求めます。その合計に加算したときに16の倍数になる値を持つデータ文字がチェックデジットです。
        </Note>

        <p>デフォルトでは、このプロパティはFALSEに設定されています。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="iscode39withoutasterisk" />

          <strong>IsCode39WithoutAsterisk</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティは非推奨であり、将来のバージョンで削除される予定です。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="supplementtype" />

          <strong>SupplementType</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              int
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティの値は、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/barcodesupplementtypeenum">
              BarcodeSupplementTypeEnum
            </a>
          </strong>

          {" "}

          列挙定数のOR結合です。このプロパティは、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#ean813">
            EAN 8, 13
          </a>

          、{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#upc-a">
            UPC-A
          </a>

          、および{" "}

          <a href="/ja/fine-reader/engine/specifications/barcode-types#upc-e">
            UPC-E
          </a>

          {" "}

          タイプのバーコードにのみ使用できます。たとえば、BS\_Void | BS\_2Digitsに設定した場合、ABBYY FineReader Engineは補助バーコードなし、または2桁の補助バーコードありのいずれかでバーコードブロックの認識を試みます。
        </p>

        <p>
          デフォルトでは、このプロパティはBS\_Autodetectに設定されており、ABBYY FineReader Engineが補助バーコードの種類を自動的に検出します。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                                               | 説明                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                         | 別のオブジェクトの対応するプロパティの値を使用して、現在のオブジェクトのプロパティを初期化します。 |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                       | ディスク上のファイルからオブジェクトの内容を復元します。                      |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **注:** *Windows のみ。* | グローバル メモリからオブジェクトの内容を復元します。                       |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                           | オブジェクトの内容をディスク上のファイルに保存します。                       |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **注:** *Windows のみ。*     | オブジェクトの内容をグローバル メモリに保存します。                        |

<div id="related-objects">
  ## 関連オブジェクト
</div>

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/barcodeparams.gif?s=800f6aa2f896bcec0663854c469b87b1" alt="BarcodeParams" width="416" height="63" data-path="images/fine-reader/engine/barcodeparams.gif" />[](/ja/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#barcodeparams)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageanalysisparams#barcodeparams)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block)[](/ja/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageanalysisparams)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## 出力パラメーター
</div>

このオブジェクトは、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [CreateBarcodeParams](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドによって出力されるパラメーターです。

<div id="input-parameter">
  ## 入力パラメーター
</div>

このオブジェクトは、次のメソッドの入力パラメーターとして渡されます。

* [FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) オブジェクトの [ExtractBarcodes](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/extractbarcodes-method) メソッド

<div id="see-also">
  ## 関連項目
</div>

[バーコードの認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-barcodes)

[バーコードの種類](/ja/fine-reader/engine/specifications/barcode-types)

[前処理、解析、認識、合成のパラメーター調整](/ja/fine-reader/engine/guided-tour/advanced-techniques/tuning-parameters-of-preprocessing-analysis-recognition-and-synthesis)

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)