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

# CheckmarkBlock オブジェクト（ICheckmarkBlock インターフェイス）

> ABBYY FineReader Engine API の CheckmarkBlock オブジェクト（ICheckmarkBlock インターフェイス）。チェックマーク ブロックに固有のプロパティ（画像前処理、チェックマークの型、修正フラグ、学習データ、認識結果（CheckmarkState、IsSuspicious））を提供します。IBlock から派生しています。

このオブジェクトでは、チェックマーク ブロックの特定のプロパティにアクセスできます。ICheckmarkBlock インターフェイスは [IBlock](/ja/fine-reader/engine/api-reference/layout-related-objects/block) インターフェイスから派生しており、そのすべてのプロパティを継承します。また、このオブジェクトは [CheckmarkGroup](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup) コレクションの要素になることがあります。

このオブジェクトのプロパティは、次の 2 つのグループに分けられます。

* ブロック内のチェックマーク認識処理に影響するプロパティです。これには、ImageProcessingParams、CheckmarkType、IsCorrectionEnabled、BlackThreshold、SuspiciousDistance、TrainingData があります。これらのプロパティを使用すると、1 つのブロックに対してチェックマーク処理の特別なパラメーターを設定できます。
* 認識結果を表す、それ以外のすべてのプロパティです。

<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 colspan="3">
        <p>
          <a name="group_1" />

          <em>処理設定</em>
        </p>
      </td>
    </tr>

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

          <strong>ImageProcessingParams</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams">
              ImageProcessingParams
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          チェックマークブロック内の画像前処理に影響するプロパティのセットへのアクセスを提供します。
        </p>
      </td>
    </tr>

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

          <strong>CheckmarkType</strong>
        </p>
      </td>

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

      <td>
        <p>
          認識に使用するチェックマークの種類を指定します。チェックマークブロックを手動で作成する場合は、このプロパティを設定してチェックマークの種類を指定します。レイアウト解析中に画像上でチェックマークが検出された場合、種類は自動的に検出されます。
        </p>

        <p>注意：</p>

        <ul>
          <li>
            このプロパティは、同一グループに属するすべてのチェックマークで同一でなければなりません。
          </li>

          <li>
            チェックマークの種類が CMT\_Custom の場合、認識されたチェックマークはチェック済みまたは未チェックのいずれかになります ({" "}
            <strong>CheckmarkState</strong> プロパティの説明を参照してください) 。
          </li>
        </ul>

        <p>デフォルト値は CMT\_Empty です。</p>
      </td>
    </tr>

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

          <strong>IsCorrectionEnabled</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>
          このプロパティを TRUE に設定すると、チェックマークブロックを選択して修正できます。
        </p>

        <p>注意：</p>

        <ul>
          <li>
            このプロパティは、同一グループに属するすべてのチェックマークで同一でなければなりません。
          </li>

          <li>
            <strong>CheckmarkType</strong> プロパティが CMT\_Custom の場合、このプロパティの値は無視されます。この種類の認識されたチェックマークはチェック済みまたは未チェックのいずれかになります ({" "}
            <strong>CheckmarkState</strong> プロパティの説明を参照してください) 。
          </li>
        </ul>

        <p>デフォルト値は FALSE です。</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>カスタムトレーニング済みチェックマークの処理設定</em>
        </p>
      </td>
    </tr>

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

          <strong>BlackThreshold</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>
          チェックマークがチェック済みと見なされるために必要な黒色の割合を指定します。このプロパティは、型が{" "}

          <a href="/ja/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">
            CMT\_Custom
          </a>

          のチェックマークにのみ使用できます。
        </p>

        <p>デフォルトでは -1 です。</p>

        <p>
          チェックマークのトレーニング後、またはこのチェックマークの{" "}
          <strong>TrainingData</strong> を読み込んだ場合、この値は変更されます。<strong> </strong>詳細については{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">
            チェックマークの認識
          </a>

          を参照してください。
        </p>
      </td>
    </tr>

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

          <strong>SuspiciousDistance</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>AmountOfBlack</strong> と{" "}
          <strong>BlackThreshold</strong> の差の絶対値がこのプロパティの値以下の場合、<strong>IsSuspicious</strong> プロパティが TRUE に設定されます。
        </p>

        <p>
          このプロパティは、型が{" "}

          <a href="/ja/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">
            CMT\_Custom
          </a>

          のチェックマークにのみ使用できます。
        </p>

        <p>デフォルト値は -1 です。</p>

        <p>
          チェックマークのトレーニング後、またはこのチェックマークの{" "}
          <strong>TrainingData</strong> を読み込んだ場合、この値は変更されます。詳細については{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">
            チェックマークの認識
          </a>

          を参照してください。
        </p>
      </td>
    </tr>

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

          <strong>TrainingData</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarktrainingdata">
              CheckmarkTrainingData
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          チェックマークのトレーニングデータを指定します。このプロパティは、型が{" "}

          <a href="/ja/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">
            CMT\_Custom
          </a>

          のチェックマークにのみ意味があります。
        </p>

        <p>
          チェックマークのトレーニングデータは、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/learncheckmarks-method">
              IFRPage::LearnCheckmarks
            </a>

            {" "}
          </strong>

          メソッドを使用したチェックマークトレーニング中に、CMT\_Custom 型の各チェックマークブロックに対して作成されます。
        </p>

        <p>
          CMT\_Custom 型のチェックマークにトレーニングデータを使用する場合は、対応するチェックマークブロックのこのプロパティの値を、トレーニング中に取得した適切な{" "}
          <strong>CheckmarkTrainingData</strong> オブジェクトで初期化する必要があります。詳細については{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">
            チェックマークの認識
          </a>

          .
        </p>

        <p>
          このプロパティは、<strong> BlackThreshold</strong> および{" "}
          <strong>SuspiciousDistance</strong> プロパティの値と連動しています。新しい{" "}
          <strong>CheckmarkTrainingData</strong> オブジェクトがこのプロパティに割り当てられると、<strong>BlackThreshold</strong> および{" "}
          <strong>SuspiciousDistance</strong> は、そのオブジェクトの保存時の値に設定されます。逆に、{" "}
          <strong>BlackThreshold</strong> および{" "}
          <strong>SuspiciousDistance</strong> を変更してこのプロパティの値を保存すると、これら2つのプロパティの値に関する情報を保持した新しい <strong>CheckmarkTrainingData</strong>{" "}
          オブジェクトが返されます。
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <a name="group_2" />

          <em>認識結果</em>
        </p>
      </td>
    </tr>

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

          <strong>CheckmarkState</strong>
        </p>
      </td>

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

      <td>
        <p>
          チェックマークブロックの状態 (チェック済み、未チェック、修正済み) を返します。
        </p>

        <Note>
          CheckmarkType プロパティが CMT\_Custom の場合、認識されたチェックマークはチェック済みまたは未チェックのいずれかになり、修正済み状態にはなりません。
        </Note>
      </td>
    </tr>

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

          <strong>IsSuspicious</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>
          このプロパティが TRUE に設定されている場合、チェックマークの認識結果が不確実であることを示します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>AmountOfBlack</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>
          チェックマーク画像における黒色の割合を返します。
        </p>
      </td>
    </tr>
  </tbody>
</table>

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

| 名前                                                                                                                       | 説明                                            |
| ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | 現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。 |

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

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/checkmarkblock.gif?s=5b91223e777f202ccf25e73ff7fb603c" alt="CheckmarkBlock" width="274" height="224" data-path="images/fine-reader/engine/checkmarkblock.gif" />[](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarktrainingdata)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block#region)[](/ja/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)[](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block)[](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout)

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

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

このオブジェクトは、以下のメソッドおよびプロパティの出力パラメーターです。

* [Block](/ja/fine-reader/engine/api-reference/layout-related-objects/block) オブジェクトの [GetAsCheckmarkBlock](/ja/fine-reader/engine/api-reference/layout-related-objects/block/getascheckmarkblock-method) メソッド
* [CheckmarkGroup](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup) オブジェクトの [Item](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method) メソッド、[AddNew](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup/addnew-method) メソッド

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

[Block](/ja/fine-reader/engine/api-reference/layout-related-objects/block)

[CheckmarkGroup](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)

[Layout と Block の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[チェックマークの認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks)

[Properties の使用](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)