> ## 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-Objekt (ICheckmarkBlock-Schnittstelle)

> CheckmarkBlock-Objekt (ICheckmarkBlock-Schnittstelle) in der ABBYY FineReader Engine API — Stellt spezifische Eigenschaften eines Häkchenblocks bereit — Bildvorverarbeitung, Häkchentyp, Korrekturkennzeichen, Trainingsdaten und Erkennungsergebnisse (CheckmarkState, IsSuspicious); abgeleitet von IBlock.

Dieses Objekt ermöglicht den Zugriff auf bestimmte Eigenschaften eines Häkchenblocks. Die ICheckmarkBlock-Schnittstelle ist von der [IBlock](/de/fine-reader/engine/api-reference/layout-related-objects/block)-Schnittstelle abgeleitet und erbt alle deren Eigenschaften. Dieses Objekt kann ein Element der [CheckmarkGroup](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)-Sammlung sein.

Die Eigenschaften dieses Objekts lassen sich in zwei Gruppen unterteilen:

* Eigenschaften, die den Prozess der Häkchenerkennung im Block beeinflussen. Dazu gehören ImageProcessingParams, CheckmarkType, IsCorrectionEnabled, BlackThreshold, SuspiciousDistance und TrainingData. Über diese Eigenschaften können Sie spezielle Parameter für die Häkchenverarbeitung eines einzelnen Blocks festlegen.
* alle übrigen Eigenschaften, die die Erkennungsergebnisse darstellen.

<div id="properties">
  ## Eigenschaften
</div>

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

      <th>
        <p>
          <strong>Typ</strong>
        </p>
      </th>

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

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

          <em>Verarbeitungseinstellungen</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Ermöglicht den Zugriff auf die Eigenschaften, die sich auf die Bildvorverarbeitung innerhalb des Häkchenblocks auswirken.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Gibt den für die Erkennung verwendeten Häkchentyp an. Wenn Sie Häkchen-Blöcke manuell erstellen, legen Sie diese Eigenschaft fest, um den Häkchentyp anzugeben. Wenn während der Layout-Analyse Häkchen auf dem Bild gefunden werden,
          wird der Typ automatisch erkannt.
        </p>

        <p>Hinweise:</p>

        <ul>
          <li>Diese Eigenschaft muss für alle Häkchen identisch sein, die zu einer Gruppe gehören.</li>

          <li>
            Wenn der Häkchentyp CMT\_Custom ist, kann ein erkanntes Häkchen entweder markiert oder nicht markiert sein (siehe die Beschreibung der Eigenschaft <strong>CheckmarkState</strong>).
          </li>
        </ul>

        <p>Der Standardwert ist CMT\_Empty.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Wenn diese Eigenschaft auf TRUE gesetzt ist, bedeutet dies, dass der Häkchenblock ausgewählt und anschließend korrigiert werden kann.</p>
        <p>Hinweise:</p>

        <ul>
          <li>Diese Eigenschaft muss für alle Häkchen identisch sein, die zu derselben Gruppe gehören.</li>

          <li>
            Wenn die Eigenschaft <strong>CheckmarkType</strong> CMT\_Custom ist, wird der Wert dieser Eigenschaft ignoriert: Ein erkanntes Häkchen dieses Typs kann entweder gesetzt oder nicht gesetzt sein (siehe die
            Beschreibung der Eigenschaft <strong>CheckmarkState</strong>).
          </li>
        </ul>

        <p>Der Standardwert ist FALSE.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Einstellungen für die Verarbeitung von benutzerdefiniert trainierten Häkchen</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Gibt den prozentualen Schwarzanteil an, der erforderlich ist, um das Häkchen als gesetzt zu betrachten. Diese Eigenschaft kann nur für Häkchen vom Typ{" "}
          <a href="/de/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">CMT\_Custom</a> verwendet werden.
        </p>

        <p>Standardmäßig beträgt er -1.</p>

        <p>
          Nach dem Training des Häkchens oder wenn Sie die <strong>TrainingData</strong> für dieses Häkchen laden, wird dieser Wert geändert.<strong> </strong>Details finden Sie unter{" "}
          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">Erkennen von Häkchen</a>.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Gibt den Abstand zum Schwarzschwellenwert an, bei dem das Häkchen als unsicher erkannt wird. Wenn der absolute Wert der Differenz zwischen <strong>AmountOfBlack</strong> und{" "}
          <strong>BlackThreshold</strong> kleiner oder gleich dem Wert dieser Eigenschaft ist, wird die Eigenschaft <strong>IsSuspicious</strong> auf TRUE gesetzt.
        </p>

        <p>
          Diese Eigenschaft kann nur für Häkchen vom Typ <a href="/de/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">CMT\_Custom</a> verwendet werden.
        </p>

        <p>Der Standardwert ist -1.</p>

        <p>
          Nach dem Training des Häkchens oder wenn Sie die <strong>TrainingData</strong> für dieses Häkchen laden, wird dieser Wert geändert. Weitere Informationen finden Sie unter{" "}
          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">Erkennen von Häkchen</a>.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Gibt die Trainingsdaten für Häkchen an. Diese Eigenschaft ist nur für Häkchen des Typs{" "}
          <a href="/de/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">CMT\_Custom</a> relevant.
        </p>

        <p>
          Häkchen-Trainingsdaten werden für jeden Häkchenblock des Typs CMT\_Custom beim Häkchen-Training mit der{" "}

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

          Methode erstellt.
        </p>

        <p>
          Wenn Sie Trainingsdaten für ein Häkchen des Typs CMT\_Custom verwenden möchten, sollten Sie den Wert dieser Eigenschaft des entsprechenden Häkchenblocks mit einem geeigneten{" "}
          <strong>CheckmarkTrainingData</strong>-Objekt initialisieren, das beim Training erstellt wurde. Weitere Informationen finden Sie unter{" "}
          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">Erkennen von Häkchen</a>.
        </p>

        <p>
          Diese Eigenschaft hängt mit den Werten der Eigenschaften<strong> BlackThreshold</strong> und <strong>SuspiciousDistance</strong> zusammen: Wenn dieser Eigenschaft ein neues <strong>CheckmarkTrainingData</strong>-Objekt
          zugewiesen wird, werden <strong>BlackThreshold</strong> und <strong>SuspiciousDistance</strong> auf die Werte gesetzt, mit denen dieses Objekt gespeichert wurde. Wenn Sie hingegen{" "}
          <strong>BlackThreshold</strong> und <strong>SuspiciousDistance</strong> ändern und den Wert dieser Eigenschaft speichern, erhalten Sie ein neues <strong>CheckmarkTrainingData</strong>-Objekt, das die
          Informationen zu den Werten dieser beiden Eigenschaften enthält.
        </p>
      </td>
    </tr>

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

          <em>Erkennungsergebnisse</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Gibt den Status des Häkchen-Blocks zurück: markiert, nicht markiert, korrigiert.</p>
        <Note>Wenn die Eigenschaft CheckmarkType den Wert CMT\_Custom hat, kann ein erkanntes Häkchen entweder markiert oder nicht markiert sein; es kann nicht den Status „korrigiert“ haben.</Note>
      </td>
    </tr>

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

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

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

      <td>
        <p>Ist diese Eigenschaft auf TRUE gesetzt, bedeutet dies, dass das Häkchen nicht eindeutig erkannt wurde.</p>
      </td>
    </tr>

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

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

          , nur lesbar
        </p>
      </td>

      <td>
        <p>Gibt den prozentualen Anteil schwarzer Farbe im Bild des Häkchens zurück.</p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                     | Beschreibung                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| [CopyFrom](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts. |

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

[Objektdiagramm](/de/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Ausgabeparameter
</div>

Dieses Objekt ist der Ausgabeparameter der folgenden Methoden und Eigenschaften:

* Methode [GetAsCheckmarkBlock](/de/fine-reader/engine/api-reference/layout-related-objects/block/getascheckmarkblock-method) des Objekts [Block](/de/fine-reader/engine/api-reference/layout-related-objects/block)
* Methoden [Item](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method), [AddNew](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup/addnew-method) des Objekts [CheckmarkGroup](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)

<div id="see-also">
  ## Siehe auch
</div>

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

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

[Arbeiten mit Layout und Blocks](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[Erkennen von Häkchen](/de/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks)

[Arbeiten mit Eigenschaften](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)