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

# Objet CheckmarkBlock (interface ICheckmarkBlock)

> Objet CheckmarkBlock (interface ICheckmarkBlock) dans l’API ABBYY FineReader Engine — fournit les propriétés spécifiques d’un bloc de coche — prétraitement de l’image, type de coche, indicateur de correction, données d’entraînement et résultats de reconnaissance (CheckmarkState, IsSuspicious) ; dérivé de IBlock.

Cet objet permet d'accéder aux propriétés spécifiques d'un bloc de coche. L'interface ICheckmarkBlock dérive de l'interface [IBlock](/fr/fine-reader/engine/api-reference/layout-related-objects/block) et hérite de toutes ses propriétés. Cet objet peut être un élément de la collection [CheckmarkGroup](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup).

Les propriétés de cet objet peuvent être réparties en deux groupes :

* les propriétés qui influent sur le processus de reconnaissance des coches dans le bloc. Il s'agit de ImageProcessingParams, CheckmarkType, IsCorrectionEnabled, BlackThreshold, SuspiciousDistance et TrainingData. C'est à l'aide de ces propriétés que vous pouvez définir des paramètres spéciaux de traitement des coches pour un seul bloc.
* toutes les autres propriétés, qui représentent les résultats de la reconnaissance.

<div id="properties">
  ## Propriétés
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

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

          <em>Processing settings</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Provides access to the set of properties affecting image preprocessing
          inside the checkmark block.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Specifies the checkmark type used for recognition. When creating
          checkmark blocks manually, set this property to specify checkmark
          type. When checkmarks are found on the image during layout analysis,
          the type is detected automatically.
        </p>

        <p>Notes:</p>

        <ul>
          <li>
            This property must be identical fr all checkmarks belonging to a
            single group.
          </li>

          <li>
            If the type of checkmark is CMT\_Custom, recognized checkmark can
            be either checked or unchecked (see the description of the{" "}
            <strong>CheckmarkState</strong> property).
          </li>
        </ul>

        <p>The default value is CMT\_Empty.</p>
      </td>
    </tr>

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

          <strong>IsCorrectionEnabled</strong>
        </p>
      </td>

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

      <td>
        <p>
          This property set to TRUE means that checkmark block can be selected
          and then corrected.
        </p>

        <p>Remarques :</p>

        <ul>
          <li>
            Cette propriété doit être identique pour toutes les coches appartenant à un
            même groupe.
          </li>

          <li>
            Si la propriété <strong>CheckmarkType</strong> est CMT\_Custom,
            la valeur de cette propriété est ignorée : la coche reconnue de ce
            type peut être cochée ou décochée (voir la description de la propriété{" "}
            <strong>CheckmarkState</strong>).
          </li>
        </ul>

        <p>La valeur par défaut est FALSE.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Settings for processing custom trained checkmarks</em>
        </p>
      </td>
    </tr>

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

          <strong>BlackThreshold</strong>
        </p>
      </td>

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

      <td>
        <p>
          Specifies the percentage of black color which is necessary to consider
          the checkmark checked. This property can be used only for checkmarks
          of the type{" "}

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

          .
        </p>

        <p>By default, it is -1.</p>

        <p>
          After checkmark training or when you load the{" "}
          <strong>TrainingData</strong> for this checkmark this value is
          changed.<strong> </strong>See details in{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">
            Recognizing Checkmarks
          </a>

          .
        </p>
      </td>
    </tr>

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

          <strong>SuspiciousDistance</strong>
        </p>
      </td>

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

      <td>
        <p>
          Specifies the distance from black threshold which makes the checkmark
          uncertainly recognized. If the absolute value of the difference
          between <strong>AmountOfBlack</strong> and{" "}
          <strong>BlackThreshold</strong> is less than or equal to the value of
          this property, the <strong>IsSuspicious</strong> property will be set
          to TRUE.
        </p>

        <p>
          This property can be used only for checkmarks of the type{" "}

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

          .
        </p>

        <p>The default value is -1.</p>

        <p>
          After checkmark training or when you load the{" "}
          <strong>TrainingData</strong> for this checkmark this value is
          changed. See details in{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">
            Recognizing Checkmarks
          </a>

          .
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Specifies the checkmark training data. This property makes sense only
          for checkmarks of the type{" "}

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

          .
        </p>

        <p>
          Checkmark training data is created for each checkmark block of the
          type CMT\_Custom during checkmark training using the{" "}

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

            {" "}
          </strong>

          method.
        </p>

        <p>
          If you want to use training data for a checkmark of the type
          CMT\_Custom, you should initialize the value of this property of
          corresponding checkmark block with the suitable{" "}
          <strong>CheckmarkTrainingData</strong> object obtained during
          training. See details in{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">
            Recognizing Checkmarks
          </a>

          .
        </p>

        <p>
          Cette propriété est corrélée avec les valeurs des propriétés
          <strong> BlackThreshold</strong> et{" "}
          <strong>SuspiciousDistance</strong> : lorsqu'un nouvel objet{" "}
          <strong>CheckmarkTrainingData</strong> est assigné à cette
          propriété, <strong>BlackThreshold</strong> et{" "}
          <strong>SuspiciousDistance</strong> prennent les valeurs avec lesquelles
          cet objet a été enregistré. Inversement, lorsque vous modifiez{" "}
          <strong>BlackThreshold</strong> et{" "}
          <strong>SuspiciousDistance</strong> et enregistrez la valeur de cette
          propriété, vous obtenez un nouvel objet <strong>CheckmarkTrainingData</strong>{" "}
          qui conserve les informations relatives aux valeurs de ces deux
          propriétés.
        </p>
      </td>
    </tr>

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

          <em>Résultats de la reconnaissance</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Renvoie l'état du bloc de coche : coché, non coché,
          corrigé.
        </p>

        <Note>
          Si la propriété CheckmarkType est CMT\_Custom, la coche reconnue
          peut être cochée ou non cochée, mais ne peut pas se trouver dans l'état
          corrigé.
        </Note>
      </td>
    </tr>

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

          <strong>IsSuspicious</strong>
        </p>
      </td>

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

      <td>
        <p>
          Lorsque cette propriété est définie sur TRUE, cela indique que la coche a été reconnue
          avec incertitude.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>AmountOfBlack</strong>
        </p>
      </td>

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>
          Renvoie le pourcentage de noir sur l'image de la coche.
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Méthodes
</div>

| Nom                                                                                                                      | Description                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| [CopyFrom](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialise les propriétés de l’objet courant avec les valeurs des propriétés similaires d’un autre objet. |

<div id="related-objects">
  ## Objets associés
</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" />[](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarktrainingdata)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block#region)[](/fr/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams)[](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)[](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layout)

[Diagramme des objets](/fr/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Paramètre de sortie
</div>

Cet objet est le paramètre de sortie des méthodes et propriétés suivantes :

* méthode [GetAsCheckmarkBlock](/fr/fine-reader/engine/api-reference/layout-related-objects/block/getascheckmarkblock-method) de l’objet [Block](/fr/fine-reader/engine/api-reference/layout-related-objects/block)
* méthodes [Item](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method), [AddNew](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup/addnew-method) de l’objet [CheckmarkGroup](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)

<div id="see-also">
  ## Voir aussi
</div>

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

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

[Travailler avec Layout et les objets Block](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[Reconnaissance des coches](/fr/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks)

[Travailler avec les propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)