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

# Objeto CheckmarkBlock (interfaz ICheckmarkBlock)

> Objeto CheckmarkBlock (interfaz ICheckmarkBlock) en la API de ABBYY FineReader Engine: proporciona propiedades específicas de un bloque de marca de verificación: preprocesamiento de imágenes, tipo de marca de verificación, indicador de corrección, datos de entrenamiento y resultados de reconocimiento (CheckmarkState, IsSuspicious); deriva de IBlock.

Este objeto permite acceder a propiedades específicas de un bloque de marca de verificación. La interfaz ICheckmarkBlock deriva de la interfaz [IBlock](/es/fine-reader/engine/api-reference/layout-related-objects/block) y hereda todas sus propiedades. Este objeto puede ser un elemento de la colección [CheckmarkGroup](/es/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup).

Las propiedades de este objeto se pueden dividir en dos grupos:

* las propiedades que afectan al proceso de reconocimiento de marcas de verificación en el bloque. Estas son ImageProcessingParams, CheckmarkType, IsCorrectionEnabled, BlackThreshold, SuspiciousDistance y TrainingData. Mediante estas propiedades, puede establecer parámetros específicos para el procesamiento de marcas de verificación de un solo bloque.
* todas las demás propiedades, que representan los resultados del reconocimiento.

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

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

      <th>
        <p>
          <strong>Tipo</strong>
        </p>
      </th>

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

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

          <em>Configuración del procesamiento</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Proporciona acceso al conjunto de propiedades que afectan al preprocesamiento de la imagen dentro del bloque de marca de verificación.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica el tipo de marca de verificación que se usa para el reconocimiento. Al crear bloques de marcas de verificación manualmente, establezca esta propiedad para indicar el tipo de marca de verificación. Cuando se detectan marcas de verificación en la imagen durante el
          análisis del layout, el tipo se detecta automáticamente.
        </p>

        <p>Notas:</p>

        <ul>
          <li>Esta propiedad debe ser la misma para todas las marcas de verificación que pertenezcan a un mismo grupo.</li>

          <li>
            Si el tipo de marca de verificación es CMT\_Custom, la marca de verificación reconocida puede estar marcada o desmarcada (consulte la descripción de la propiedad <strong>CheckmarkState</strong>).
          </li>
        </ul>

        <p>El valor predeterminado es CMT\_Empty.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Si esta propiedad se establece en TRUE, el bloque de marca de verificación puede seleccionarse y luego corregirse.</p>
        <p>Notas:</p>

        <ul>
          <li>Esta propiedad debe ser idéntica para todas las marcas de verificación que pertenecen a un mismo grupo.</li>

          <li>
            Si la propiedad <strong>CheckmarkType</strong> es CMT\_Custom, el valor de esta propiedad se ignora: una marca de verificación reconocida de este tipo puede estar marcada o desmarcada (consulte la
            descripción de la propiedad <strong>CheckmarkState</strong>).
          </li>
        </ul>

        <p>El valor predeterminado es FALSE.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Configuración para procesar marcas de verificación entrenadas a medida</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica el porcentaje de negro necesario para considerar seleccionada la marca de verificación. Esta propiedad solo se puede usar para marcas de verificación del tipo{" "}
          <a href="/es/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">CMT\_Custom</a>.
        </p>

        <p>De forma predeterminada, es -1.</p>

        <p>
          Después de entrenar la marca de verificación o al cargar <strong>TrainingData</strong> para esta marca de verificación, este valor cambia.<strong> </strong>Consulte los detalles en{" "}
          <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">Reconocimiento de marcas de verificación</a>.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica la distancia respecto al umbral de negro que hace que la marca de verificación se reconozca como dudosa. Si el valor absoluto de la diferencia entre <strong>AmountOfBlack</strong> y{" "}
          <strong>BlackThreshold</strong> es menor o igual que el valor de esta propiedad, la propiedad <strong>IsSuspicious</strong> se establecerá en TRUE.
        </p>

        <p>
          Esta propiedad solo se puede usar para marcas de verificación del tipo <a href="/es/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">CMT\_Custom</a>.
        </p>

        <p>El valor predeterminado es -1.</p>

        <p>
          Después del entrenamiento de la marca de verificación, o al cargar <strong>TrainingData</strong> para esta marca de verificación, este valor cambia. consulte los detalles en{" "}
          <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">Reconocimiento de marcas de verificación</a>.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica los datos de entrenamiento de la marca de verificación. Esta propiedad solo tiene sentido para las marcas de verificación del tipo{" "}
          <a href="/es/fine-reader/engine/api-reference/enumerations/checkmarktypeenum#cmt_custom">CMT\_Custom</a>.
        </p>

        <p>
          Los datos de entrenamiento de la marca de verificación se crean para cada bloque de marca de verificación del tipo CMT\_Custom durante el entrenamiento de marcas de verificación mediante el método{" "}

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

          .
        </p>

        <p>
          Si desea usar datos de entrenamiento para una marca de verificación del tipo CMT\_Custom, debe inicializar el valor de esta propiedad del bloque de marca de verificación correspondiente con el objeto{" "}
          <strong>CheckmarkTrainingData</strong> adecuado obtenido durante el entrenamiento. Para obtener más información, consulte{" "}
          <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks#custom">Reconocimiento de marcas de verificación</a>.
        </p>

        <p>
          Esta propiedad está relacionada con los valores de las propiedades <strong>BlackThreshold</strong> y <strong>SuspiciousDistance</strong>: cuando se asigna un nuevo objeto <strong>CheckmarkTrainingData</strong> a esta
          propiedad, <strong>BlackThreshold</strong> y <strong>SuspiciousDistance</strong> se establecen en los valores con los que se guardó ese objeto. A la inversa, cuando cambia{" "}
          <strong>BlackThreshold</strong> y <strong>SuspiciousDistance</strong> y guarda el valor de esta propiedad, recibe un nuevo objeto <strong>CheckmarkTrainingData</strong> que conserva la
          información sobre los valores de esas dos propiedades.
        </p>
      </td>
    </tr>

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

          <em>Resultados del reconocimiento</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Devuelve el estado del bloque de marca de verificación: marcada, no marcada o corregida.</p>
        <Note>Si la propiedad CheckmarkType es CMT\_Custom, la marca de verificación reconocida solo puede estar marcada o no marcada; no puede estar en estado corregido.</Note>
      </td>
    </tr>

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

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

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

      <td>
        <p>Si esta propiedad está establecida en TRUE, significa que la marca de verificación se reconoció de forma incierta.</p>
      </td>
    </tr>

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

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

          , de solo lectura
        </p>
      </td>

      <td>
        <p>Devuelve el porcentaje de negro en la imagen de la marca de verificación.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nombre                                                                                                                   | Descripción                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| [CopyFrom](/es/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Inicializa las propiedades del objeto actual con los valores de las propiedades equivalentes de otro objeto. |

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

[Diagrama de objetos](/es/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Parámetro de salida
</div>

Este objeto es el parámetro de salida de los siguientes métodos y propiedades:

* método [GetAsCheckmarkBlock](/es/fine-reader/engine/api-reference/layout-related-objects/block/getascheckmarkblock-method) del objeto [Block](/es/fine-reader/engine/api-reference/layout-related-objects/block)
* métodos [Item](/es/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method), [AddNew](/es/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup/addnew-method) del objeto [CheckmarkGroup](/es/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)

<div id="see-also">
  ## Consulte también
</div>

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

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

[Trabajar con Layout y Blocks](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[Reconocimiento de marcas de verificación](/es/fine-reader/engine/guided-tour/advanced-techniques/recognizing-checkmarks)

[Trabajar con Propiedades](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)