> ## 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 Region (interface IRegion) > Objet Region (interface IRegion) dans l’API ABBYY FineReader Engine — Objet auxiliaire stockant la région d’un bloc FineReader Engine sous la forme d’un ensemble de rectangles sans chevauchement dans l’ordre de gauche à droite ou de haut en bas. Il s'agit d'un objet auxiliaire. Il est conçu pour stocker les informations relatives à la région d'un bloc ABBYY FineReader Engine. Une région est représentée par un ensemble de rectangles : * placés sans intersections ni chevauchements * ajoutés de gauche à droite ou de haut en bas Quelques exemples de régions dans ABBYY FineReader Engine sont présentés ci-dessous : Regions Un objet Region vide peut être créé en appelant la méthode [IEngine::CreateRegion](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods), puis des rectangles peuvent y être ajoutés un par un en appelant la méthode [IRegion::AddRect](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method). Nous vous recommandons d'ajouter les rectangles de haut en bas (ou de gauche à droite), car l'objet Region est optimisé pour cet ordre, et c'est le moyen le plus rapide d'y ajouter des rectangles. L'objet Region est un objet persistant. Cela signifie que l'état actuel de l'objet peut être enregistré dans un stockage persistant. L'objet peut ensuite être recréé en lisant son état depuis ce stockage persistant. Les méthodes suivantes assurent la persistance de l'objet : Linux : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), et [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method) Windows : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method), et [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).
## Propriétés
| Nom | Type | Description | | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- | | Application | [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface), [lecture seule](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Retourne l'objet Engine. | | [Bottom](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/bottom-property) | [int](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule | Retourne la coordonnée du bord inférieur du rectangle spécifié. | | BoundingRectangle | [FRRectangle](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle), [lecture seule](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Retourne le plus petit rectangle contenant l'intégralité de la région. | | Count | [int](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule | Indique le nombre de rectangles dans la région. | | IsEmpty | [VARIANT\_BOOL](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule | Indique si la région est vide. | | [Left](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/left-property) | [int](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule | Retourne la coordonnée du bord gauche du rectangle spécifié. | | [Right](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/right-property) | [int](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule | Retourne la coordonnée du bord droit du rectangle spécifié. | | [Top](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/top-property) | [int](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), lecture seule | Retourne la coordonnée du bord supérieur du rectangle spécifié. |
## Méthodes
| Nom | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | [AddRect](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method) | Ajoute une zone à la région. | | [AddRegion](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addregion-method) | Ajoute une nouvelle zone à une région existante. | | [CopyFrom](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialise les propriétés de l’objet actuel avec les valeurs des propriétés correspondantes d’un autre objet. | | [CutRect](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/cutrect-method) | Découpe une zone rectangulaire de la région. | | [HasIntersectionWithRect](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithrect-method) | Détermine si la région est en intersection avec le rectangle spécifié. | | [HasIntersectionWithRegion](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithregion-method) | Détermine si la région est en intersection avec la région spécifiée. | | [IsEqual](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isequal-method) | Détermine si la région est égale à la région spécifiée. | | [IsPointInRegion](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/ispointinregion-method) | Détermine si le point spécifié se trouve dans la région. | | [IsRectInRegion](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isrectinregion-method) | Détermine si le rectangle spécifié est contenu dans la région. | | [IsRegionInRegion](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isregioninregion-method) | Détermine si la région spécifiée est contenue dans la région. | | [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method) | Restaure le contenu de l’objet à partir d’un fichier sur le disque. | | [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)

**Remarque :** *Windows uniquement.* | Restaure le contenu de l’objet à partir de la mémoire globale. | | [MakeEmpty](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/makeempty-method) | Supprime tous les rectangles de la région. | | [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) | Enregistre le contenu de l’objet dans un fichier sur le disque. | | [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)

**Remarque :** *Windows uniquement.* | Enregistre le contenu de l’objet dans la mémoire globale. | Region[](/fr/fine-reader/engine/api-reference/document-comparison-objects/changelocation/regionforpage-property)[](/fr/fine-reader/engine/api-reference/document-comparison-objects/changelocation)[](/fr/fine-reader/engine/api-reference/document-related-objects/mrzfield)[](/fr/fine-reader/engine/api-reference/document-related-objects/mrzline)[](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion#sourceregion)[](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle)[](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion)[](/fr/fine-reader/engine/api-reference/document-related-objects/businesscard)[](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection)[](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fr/fine-reader/engine/api-reference/text-related-objects/charparams#characterregion)[](/fr/fine-reader/engine/api-reference/text-related-objects/charparams)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block#region)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/text-related-objects/word) [Diagramme des objets](/fr/fine-reader/engine/api-reference/object-diagram)
## Paramètre de sortie
Cet objet constitue le paramètre de sortie de la méthode [CreateRegion](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) de l’objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface).
## Paramètre d'entrée
Cet objet est passé comme paramètre d'entrée aux méthodes suivantes : * méthodes [AnalyzeRegion](/fr/fine-reader/engine/api-reference/document-related-objects/frpage/analyzeregion-method), [SynthesizeBusinessCard](/fr/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method), [SynthesizeBusinessCardEx](/fr/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscardex-method) de l'objet [FRPage](/fr/fine-reader/engine/api-reference/document-related-objects/frpage) * méthodes [RemoveColorObjects](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/removecolorobjects-method), [RemoveMotionBlur](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/removemotionblur-method), [RemoveGarbage](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/removegarbage-method), [SmoothImage](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/smoothimage-method), [SaveImageRegionTo](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/saveimageregionto-method) de l'objet [ImageDocument](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument) * méthode [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) * méthode [AddNew](/fr/fine-reader/engine/api-reference/layout-related-objects/separatorgroup/addnew-method) de l'objet [SeparatorGroup](/fr/fine-reader/engine/api-reference/layout-related-objects/separatorgroup) * méthodes [Add](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/add-method), [InsertAt](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/insertat-method) de l'objet [RegionsCollection](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection) * méthode [SetImageData](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimage/setimagedata-method) de l'objet [TrainingImage](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimage) * méthodes [AddClipRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addclipregion-method), [AddInvertRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addinvertregion-method), [AddPaintRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addpaintregion-method), [AddReplaceBlackPixelsRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplaceblackpixelsregion-method), [AddReplaceWhitePixelsRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplacewhitepixelsregion-method) de l'objet [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification) * Pour les composants visuels Windows : * méthodes [OnAnalyzeRegion](/fr/fine-reader/engine/visual-components-reference/iimageviewerevents/onanalyzeregion-method), [OnToolChangeBlockRegion](/fr/fine-reader/engine/visual-components-reference/iimageviewerevents/ontoolchangeblockregion-method) de l'interface [IImageViewerEvents](/fr/fine-reader/engine/visual-components-reference/iimageviewerevents) * méthodes [OnAnalyzeRegion](/fr/fine-reader/engine/visual-components-reference/izoomviewerevents/onanalyzeregion-method), [OnToolChangeBlockRegion](/fr/fine-reader/engine/visual-components-reference/izoomviewerevents/ontoolchangeblockregion-method) de l'interface [IZoomViewerEvents](/fr/fine-reader/engine/visual-components-reference/izoomviewerevents)
## Exemples
Cet objet est utilisé dans l’exemple de code [Reconnaissance des cartes de visite](/fr/fine-reader/engine/guided-tour/samples#bcr_mac) (macOS).
## Voir aussi
[Utiliser les propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)