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

# Region オブジェクト（IRegion インターフェイス）

> ABBYY FineReader Engine API の Region オブジェクト（IRegion インターフェイス）— 重なりのない矩形の集合として、左から右または上から下の順に FineReader Engine ブロックの領域を格納する補助オブジェクト。

これは補助オブジェクトです。ABBYY FineReader Engine のブロック領域に関する情報を格納するために使用されます。

領域は、一連の矩形として表されます。

* 互いに交差したり重なったりしないように配置される
* 左から右、または上から下の順に追加される

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" />

空の Region オブジェクトは、[IEngine::CreateRegion](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドを呼び出して作成できます。その後、[IRegion::AddRect](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method) メソッドを呼び出して、矩形を 1 つずつ追加できます。Region オブジェクトはこの順序での追加に最適化されており、この方法が矩形を追加する最も高速な方法であるため、矩形は上から下 (または左から右) の順に追加することをお勧めします。

Region オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。次のメソッドを使用すると、オブジェクトを永続化できます。

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)、および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<div id="properties">
  ## プロパティ
</div>

| 名前                                                                                                      | 型                                                                                                                                                                                                                                   | 説明                         |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| Application                                                                                             | [Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface), [読み取り専用](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties)                    | Engine オブジェクトを返します。        |
| [Bottom](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/bottom-property) | [int](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), 読み取り専用                                                                                                                   | 指定されたRectangleの下辺の座標を返します。 |
| BoundingRectangle                                                                                       | [FRRectangle](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle), [読み取り専用](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | 領域全体を含む最小のRectangleを返します。  |
| Count                                                                                                   | [int](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), 読み取り専用                                                                                                                   | 領域内のRectangleの数を保持します。     |
| IsEmpty                                                                                                 | [VARIANT\_BOOL](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), 読み取り専用                                                                                                         | 領域が空かどうかを示します。             |
| [Left](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/left-property)     | [int](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), 読み取り専用                                                                                                                   | 指定されたRectangleの左辺の座標を返します。 |
| [Right](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/right-property)   | [int](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), 読み取り専用                                                                                                                   | 指定されたRectangleの右辺の座標を返します。 |
| [Top](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/top-property)       | [int](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), 読み取り専用                                                                                                                   | 指定されたRectangleの上辺の座標を返します。 |

<div id="methods">
  ## メソッド
</div>

| Name                                                                                                                                             | Description                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| [AddRect](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addrect-method)                                          | 領域に領域を追加します。                                      |
| [AddRegion](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/addregion-method)                                      | 既存の領域に新しい領域を追加します。                                |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                         | 別のオブジェクトの対応するプロパティの値を使用して、現在のオブジェクトのプロパティを初期化します。 |
| [CutRect](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/cutrect-method)                                          | 領域からRectangle領域を切り取ります。                           |
| [HasIntersectionWithRect](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithrect-method)          | 領域が指定したRectangleと交差するかどうかを判定します。                  |
| [HasIntersectionWithRegion](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/hasintersectionwithregion-method)      | 領域が指定した領域と交差するかどうかを判定します。                         |
| [IsEqual](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isequal-method)                                          | 領域が指定した領域と等しいかどうかを判定します。                          |
| [IsPointInRegion](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/ispointinregion-method)                          | 指定した点が領域内にあるかどうかを判定します。                           |
| [IsRectInRegion](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isrectinregion-method)                            | 指定したRectangleが領域内に含まれているかどうかを判定します。               |
| [IsRegionInRegion](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/isregioninregion-method)                        | 指定した領域が領域内に含まれているかどうかを判定します。                      |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                       | ディスク上のファイルからオブジェクトの内容を復元します。                      |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **注:** *Windows のみ。* | グローバルメモリからオブジェクトの内容を復元します。                        |
| [MakeEmpty](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region/makeempty-method)                                      | 領域からすべてのRectangleを削除します。                          |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                           | オブジェクトの内容をディスク上のファイルに保存します。                       |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **注:** *Windows のみ。*     | オブジェクトの内容をグローバルメモリに保存します。                         |

<div id="related-objects">
  ## 関連オブジェクト
</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" />[](/ja/fine-reader/engine/api-reference/document-comparison-objects/changelocation/regionforpage-property)[](/ja/fine-reader/engine/api-reference/document-comparison-objects/changelocation)[](/ja/fine-reader/engine/api-reference/document-related-objects/mrzfield)[](/ja/fine-reader/engine/api-reference/document-related-objects/mrzline)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion#sourceregion)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/splitregion)[](/ja/fine-reader/engine/api-reference/document-related-objects/businesscard)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection)[](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/ja/fine-reader/engine/api-reference/text-related-objects/charparams#characterregion)[](/ja/fine-reader/engine/api-reference/text-related-objects/charparams)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block#region)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block)[](/ja/fine-reader/engine/api-reference/text-related-objects/word)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## 出力パラメーター
</div>

このオブジェクトは、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [CreateRegion](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドの出力パラメーターです。

<div id="input-parameter">
  ## 入力パラメーター
</div>

このオブジェクトは、次のメソッドの入力パラメーターとして渡されます。

* [AnalyzeRegion](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/analyzeregion-method)、[SynthesizeBusinessCard](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method)、[SynthesizeBusinessCardEx](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscardex-method) メソッド ([FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) オブジェクトの)
* [RemoveColorObjects](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/removecolorobjects-method)、[RemoveMotionBlur](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/removemotionblur-method)、[RemoveGarbage](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/removegarbage-method)、[SmoothImage](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/smoothimage-method)、[SaveImageRegionTo](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/saveimageregionto-method) メソッド ([ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) オブジェクトの)
* [AddNew](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup/addnew-method) メソッド ([CheckmarkGroup](/ja/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup) オブジェクトの)
* [AddNew](/ja/fine-reader/engine/api-reference/layout-related-objects/separatorgroup/addnew-method) メソッド ([SeparatorGroup](/ja/fine-reader/engine/api-reference/layout-related-objects/separatorgroup) オブジェクトの)
* [Add](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/add-method)、[InsertAt](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/insertat-method) メソッド ([RegionsCollection](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/regionscollection) オブジェクトの)
* [SetImageData](/ja/fine-reader/engine/api-reference/image-related-objects/trainingimage/setimagedata-method) メソッド ([TrainingImage](/ja/fine-reader/engine/api-reference/image-related-objects/trainingimage) オブジェクトの)
* [AddClipRegion](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/addclipregion-method)、[AddInvertRegion](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/addinvertregion-method)、[AddPaintRegion](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/addpaintregion-method)、[AddReplaceBlackPixelsRegion](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplaceblackpixelsregion-method)、[AddReplaceWhitePixelsRegion](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplacewhitepixelsregion-method) メソッド ([ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) オブジェクトの)
* Windows Visual Components:
  * [OnAnalyzeRegion](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents/onanalyzeregion-method)、[OnToolChangeBlockRegion](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents/ontoolchangeblockregion-method) メソッド ([IImageViewerEvents](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents) インターフェイスの)
  * [OnAnalyzeRegion](/ja/fine-reader/engine/visual-components-reference/izoomviewerevents/onanalyzeregion-method)、[OnToolChangeBlockRegion](/ja/fine-reader/engine/visual-components-reference/izoomviewerevents/ontoolchangeblockregion-method) メソッド ([IZoomViewerEvents](/ja/fine-reader/engine/visual-components-reference/izoomviewerevents) インターフェイスの)

<div id="samples">
  ## サンプル
</div>

このオブジェクトは、[名刺認識](/ja/fine-reader/engine/guided-tour/samples#bcr_mac) (macOS) のサンプルコードで使用されます。

<div id="see-also">
  ## 関連項目
</div>

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)