> ## 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 Region (Interfaz IRegion)

> Objeto Region (interfaz IRegion) en la API de ABBYY FineReader Engine: objeto complementario que almacena la región de un bloque de FineReader Engine como un conjunto de rectángulos sin intersecciones ni superposiciones, en orden de izquierda a derecha o de arriba a abajo.

Este es un objeto complementario. Está diseñado para almacenar información sobre la región de un bloque de ABBYY FineReader Engine.

Una región se representa como un conjunto de rectángulos:

* posicionados sin intersecciones ni superposiciones
* añadidos en orden de izquierda a derecha o de arriba a abajo

A continuación se muestran algunos ejemplos de regiones de ABBYY FineReader Engine:

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/regions.gif?s=b31b3c08fd5e02f80c97328a773e2937" alt="Regions" width="441" height="284" data-path="images/fine-reader/engine/regions.gif" />

Se puede crear un objeto Region vacío llamando al método [IEngine::CreateRegion](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods), y luego se pueden agregar rectángulos uno a uno llamando al método [IRegion::AddRect](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method). Se recomienda agregar los rectángulos en orden de arriba a abajo (o de izquierda a derecha), ya que el objeto Region está optimizado para ello y es la forma más rápida de agregarlos.

El objeto Region es un objeto persistente. Esto significa que el estado actual del objeto puede escribirse en un almacenamiento persistente y, posteriormente, el objeto puede recrearse leyendo dicho estado desde ese almacenamiento. Los siguientes métodos proporcionan la persistencia del objeto:

Linux: [SaveToFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) y [LoadFromFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) y [LoadFromMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

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

| Nombre                                                                                                  | Tipo                                                                                                                                                                                                                                         | Descripción                                                             |
| ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Application                                                                                             | [Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface), [de solo lectura](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties)                    | Devuelve el objeto Engine.                                              |
| [Bottom](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/bottom-property) | [int](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                                   | Devuelve la coordenada del borde inferior del rectángulo especificado.  |
| BoundingRectangle                                                                                       | [FRRectangle](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle), [de solo lectura](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Devuelve el rectángulo mínimo que contiene toda la región.              |
| Count                                                                                                   | [int](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                                   | Almacena el número de rectángulos de la región.                         |
| IsEmpty                                                                                                 | [VARIANT\_BOOL](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                         | Indica si la región está vacía.                                         |
| [Left](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/left-property)     | [int](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                                   | Devuelve la coordenada del borde izquierdo del rectángulo especificado. |
| [Right](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/right-property)   | [int](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                                   | Devuelve la coordenada del borde derecho del rectángulo especificado.   |
| [Top](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/top-property)       | [int](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                                   | Devuelve la coordenada del borde superior del rectángulo especificado.  |

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

| Nombre                                                                                                                                                | Descripción                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| [AddRect](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method)                                               | Agrega un área a la región.                                                                           |
| [AddRegion](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addregion-method)                                           | Agrega una nueva área a una región existente.                                                         |
| [CopyFrom](/es/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                              | Inicializa las propiedades del objeto actual con los valores de propiedades similares de otro objeto. |
| [CutRect](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/cutrect-method)                                               | Recorta un área rectangular de una región.                                                            |
| [HasIntersectionWithRect](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithrect-method)               | Determina si la región se intersecta con el rectángulo especificado.                                  |
| [HasIntersectionWithRegion](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithregion-method)           | Determina si la región se intersecta con la región especificada.                                      |
| [IsEqual](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isequal-method)                                               | Determina si la región es igual a la región especificada.                                             |
| [IsPointInRegion](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/ispointinregion-method)                               | Determina si el punto especificado se encuentra dentro de la región.                                  |
| [IsRectInRegion](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isrectinregion-method)                                 | Determina si el rectángulo especificado está contenido dentro de la región.                           |
| [IsRegionInRegion](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isregioninregion-method)                             | Determina si la región especificada está contenida dentro de la región.                               |
| [LoadFromFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                            | Restaura el contenido del objeto desde un archivo en disco.                                           |
| [LoadFromMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Nota:** *Solo Windows.* | Restaura el contenido del objeto desde la memoria global.                                             |
| [MakeEmpty](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/makeempty-method)                                           | Elimina todos los rectángulos de la región.                                                           |
| [SaveToFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                | Guarda el contenido del objeto en un archivo en disco.                                                |
| [SaveToMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Nota:** *Solo Windows.*     | Guarda el contenido del objeto en la memoria global.                                                  |

<div id="related-objects">
  ## Objetos relacionados
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/region.gif?s=7ec0a7f856b5518a3ae6334ac4ce57d3" alt="Region" width="307" height="214" data-path="images/fine-reader/engine/region.gif" />[](/es/fine-reader/engine/api-reference/document-comparison-objects/changelocation/regionforpage-property)[](/es/fine-reader/engine/api-reference/document-comparison-objects/changelocation)[](/es/fine-reader/engine/api-reference/document-related-objects/mrzfield)[](/es/fine-reader/engine/api-reference/document-related-objects/mrzline)[](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion#sourceregion)[](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle)[](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion)[](/es/fine-reader/engine/api-reference/document-related-objects/businesscard)[](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection)[](/es/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/es/fine-reader/engine/api-reference/text-related-objects/charparams#characterregion)[](/es/fine-reader/engine/api-reference/text-related-objects/charparams)[](/es/fine-reader/engine/api-reference/layout-related-objects/block#region)[](/es/fine-reader/engine/api-reference/layout-related-objects/block)[](/es/fine-reader/engine/api-reference/text-related-objects/word)

[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 del método [CreateRegion](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) del objeto [Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface).

<div id="input-parameter">
  ## Parámetro de entrada
</div>

Este objeto se utiliza como parámetro de entrada en los siguientes métodos:

* métodos [AnalyzeRegion](/es/fine-reader/engine/api-reference/document-related-objects/frpage/analyzeregion-method), [SynthesizeBusinessCard](/es/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method), [SynthesizeBusinessCardEx](/es/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscardex-method) del objeto [FRPage](/es/fine-reader/engine/api-reference/document-related-objects/frpage)
* métodos [RemoveColorObjects](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument/removecolorobjects-method), [RemoveMotionBlur](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument/removemotionblur-method), [RemoveGarbage](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument/removegarbage-method), [SmoothImage](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument/smoothimage-method), [SaveImageRegionTo](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument/saveimageregionto-method) del objeto [ImageDocument](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument)
* método [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)
* método [AddNew](/es/fine-reader/engine/api-reference/layout-related-objects/separatorgroup/addnew-method) del objeto [SeparatorGroup](/es/fine-reader/engine/api-reference/layout-related-objects/separatorgroup)
* métodos [Add](/es/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/add-method), [InsertAt](/es/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/insertat-method) del objeto [RegionsCollection](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection)
* método [SetImageData](/es/fine-reader/engine/api-reference/image-related-objects/trainingimage/setimagedata-method) del objeto [TrainingImage](/es/fine-reader/engine/api-reference/image-related-objects/trainingimage)
* métodos [AddClipRegion](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/addclipregion-method), [AddInvertRegion](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/addinvertregion-method), [AddPaintRegion](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/addpaintregion-method), [AddReplaceBlackPixelsRegion](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplaceblackpixelsregion-method), [AddReplaceWhitePixelsRegion](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplacewhitepixelsregion-method) del objeto [ImageModification](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification)
* Para Visual Components para Windows:
  * métodos [OnAnalyzeRegion](/es/fine-reader/engine/visual-components-reference/iimageviewerevents/onanalyzeregion-method), [OnToolChangeBlockRegion](/es/fine-reader/engine/visual-components-reference/iimageviewerevents/ontoolchangeblockregion-method) de la interfaz [IImageViewerEvents](/es/fine-reader/engine/visual-components-reference/iimageviewerevents)
  * métodos [OnAnalyzeRegion](/es/fine-reader/engine/visual-components-reference/izoomviewerevents/onanalyzeregion-method), [OnToolChangeBlockRegion](/es/fine-reader/engine/visual-components-reference/izoomviewerevents/ontoolchangeblockregion-method) de la interfaz [IZoomViewerEvents](/es/fine-reader/engine/visual-components-reference/izoomviewerevents)

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

Este objeto se utiliza en el código de ejemplo de [Reconocimiento de tarjetas de visita](/es/fine-reader/engine/guided-tour/samples#bcr_mac) (macOS).

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

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