> ## 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 TextBlock (interfaz ITextBlock)

> Objeto TextBlock (interfaz ITextBlock) en la API de ABBYY FineReader Engine: representa un bloque de texto; expone parámetros de preprocesamiento de imágenes, análisis y reconocimiento por bloque, BlockRole, BusinessCardFieldType, TextOrientation y el Text reconocido; deriva de IBlock.

Este objeto proporciona acceso a determinadas propiedades de un bloque de texto. Estos bloques corresponden a una zona de la imagen reconocida como texto con formato. A través de este objeto también se puede acceder al texto reconocido de la parte de la imagen que abarca este bloque. La interfaz ITextBlock deriva de la interfaz [IBlock](/es/fine-reader/engine/api-reference/layout-related-objects/block) y hereda todas sus propiedades.

Las propiedades de este objeto pueden dividirse en dos grupos:

* las propiedades que afectan al proceso de reconocimiento de texto en el bloque. Son ImageProcessingParams, AnalysisParams y RecognizerParams. Estas propiedades le permiten establecer parámetros de procesamiento especiales para un único bloque.
* las propiedades que pueden establecerse después del análisis y antes del reconocimiento, o que el programa puede completar durante el reconocimiento. Entre ellas se incluyen BlockRole y BusinessCardFieldType, que se utilizan para especificar la función del bloque en los distintos tipos de documentos. La propiedad TextOrientation también pertenece a este grupo.
* los resultados del reconocimiento. Este grupo contiene únicamente la propiedad Text, que representa el texto reconocido del bloque.

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

<table><thead><tr><th><p><strong>Nombre</strong></p></th><th><p><strong>Tipo</strong></p></th><th><p><strong>Descripción</strong></p></th></tr></thead><tbody><tr><td colspan="3"><p><em>Configuración de procesamiento</em></p></td></tr><tr><td><p><a name="analysisparams" /><strong>AnalysisParams</strong></p></td><td><p><strong><a href="/es/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams">TextBlockAnalysisParams</a></strong></p></td><td><p>Proporciona acceso a los parámetros de análisis del bloque de texto.</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 a los parámetros de preprocesamiento de la imagen del bloque de texto.</p></td></tr><tr><td><p><a name="recognizerparams" /><strong>RecognizerParams</strong></p></td><td><p><strong><a href="/es/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams">RecognizerParams</a></strong></p></td><td><p>Proporciona acceso a los parámetros de reconocimiento del bloque de texto.</p></td></tr><tr><td colspan="3"><p><em>La función y la orientación del texto</em></p></td></tr><tr><td><p><a name="blockrole" /><strong>BlockRole</strong></p></td><td><p><strong><a href="/es/fine-reader/engine/api-reference/enumerations/blockroleenum">BlockRoleEnum</a></strong></p></td><td><p>Especifica la función del bloque de texto en la estructura lógica de un documento.</p><p>De forma predeterminada, es BR\_Unknown.</p></td></tr><tr><td><p><a name="businesscardfieldtype" /><strong>BusinessCardFieldType</strong></p></td><td><p><strong><a href="/es/fine-reader/engine/api-reference/enumerations/businesscardfieldtypeenum">BusinessCardFieldTypeEnum</a></strong></p></td><td><p>Proporciona acceso a la función del bloque de texto como parte de una tarjeta de visita.</p><p>Cuando se llama al método <strong><a href="/es/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method">IFRPage::SynthesizeBusinessCard</a></strong>, FineReader Engine asume que el bloque con la función especificada en una tarjeta de visita es un campo del tipo correspondiente. Si el bloque no puede considerarse un campo de este tipo, el texto del bloque no aparecerá en el texto de la tarjeta de visita.</p><p>De forma predeterminada, es BCFT\_Unknown.</p></td></tr><tr><td><p><a name="textorientation" /><strong>TextOrientation</strong></p></td><td><p><strong><a href="/es/fine-reader/engine/api-reference/text-related-objects/textorientation">TextOrientation</a></strong></p></td><td><p>Especifica la orientación del texto en el bloque. Si la establece antes del reconocimiento, afectará a la forma en que se interpreta el texto del bloque (por ejemplo, en líneas o en columnas); de lo contrario, contendrá la orientación detectada después del reconocimiento.</p></td></tr><tr><td colspan="3"><p><em>Resultados del reconocimiento</em></p></td></tr><tr><td><p><a name="text" /><strong>Text</strong></p></td><td><p><strong><a href="/es/fine-reader/engine/api-reference/text-related-objects/text">Text</a></strong>, <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">de solo lectura</a></p></td><td><p>Contiene el texto reconocido del bloque de texto.</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>

<div id="windows">
  ### Windows
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textblock.gif?s=ca74ed6df756c415d84620c1244dfac0" alt="TextBlock" width="303" height="235" data-path="images/fine-reader/engine/textblock.gif" />[](/es/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks)[](/es/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/es/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/es/fine-reader/engine/api-reference/text-related-objects/text)[](/es/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/es/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams)[](/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/api-reference/layout-related-objects/block)[](/es/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/es/fine-reader/engine/api-reference/layout-related-objects/layout)

<div id="linux-and-macos">
  ### Linux y macOS
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textblocklinuxmac.gif?s=b97c4325e7fd9b26c3a42e5805d36f44" alt="TextBlockLinuxMac" width="303" height="238" data-path="images/fine-reader/engine/textblocklinuxmac.gif" />[](/es/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/es/fine-reader/engine/api-reference/text-related-objects/text)[](/es/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/es/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams)[](/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/api-reference/layout-related-objects/block)[](/es/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/es/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/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 corresponde al parámetro de salida del método [GetAsTextBlock](/es/fine-reader/engine/api-reference/layout-related-objects/block/getastextblock-method) del objeto [Block](/es/fine-reader/engine/api-reference/layout-related-objects/block).

<div id="samples">
  ## Ejemplos
</div>

<Accordion title="Código C#">
  ```csharp theme={null}
  int totalCharsCount = 0;
  FREngine.IBlock block;
  // Calcula el número de caracteres de un texto
  if (block.Type == FREngine.BlockTypeEnum.BT_Text)
  {
   FREngine.ITextBlock textBlock = block.GetAsTextBlock();
   int paragraphsCount = textBlock.Text.Paragraphs.Count;
   for (int iPar = 0; iPar < paragraphsCount; iPar++)
   {
    FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
    string text = par.Text;
    totalCharsCount += text.Length;
   }
  }
  ```
</Accordion>

El objeto se utiliza en los siguientes ejemplos de código:

* Linux: [CustomLanguage](/es/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/es/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/es/fine-reader/engine/guided-tour/samples#recognizedtextprocessing); y en las herramientas de demostración: [Perfiles de procesamiento predefinidos del motor](/es/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

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

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

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

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