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

# ImageDocument Object の RemoveColorObjects メソッド

> ABBYY FineReader Engine API の ImageDocument Object における RemoveColorObjects メソッド — 画像から赤、緑、青、または黄色のオブジェクトを削除します。必要に応じて、対象を指定した領域、その背景、またはスタンプや署名のみに限定できます。カラー画像でのみ使用できます。

このメソッドを使用すると、画像からカラーオブジェクトを削除できます。画像全体から赤、緑、青、または黄色のオブジェクトを削除できるほか、画像の一部、つまり指定した領域、その背景、またはその領域内のスタンプと署名だけを削除することもできます。

<Warning>
  このメソッドは、カラー画像でのみ使用できます。
</Warning>

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT RemoveColorObjects(
  IRegion*         Region,
  ObjectsColorEnum Color,
  ObjectsTypeEnum  Mode
);
```

### C\#

```csharp theme={null}
void RemoveColorObjects(
  IRegion           Region,
  ObjectsColorEnum Color,
  ObjectsTypeEnum  Mode
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub RemoveColorObjects( _
  Region As IRegion, _
  Color As ObjectsColorEnum, _
  Mode As ObjectsTypeEnum _
)
```

<div id="parameters">
  ## パラメーター
</div>

**Region**

\[in] [Region](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) 型のこのパラメーターは、オブジェクトを削除する対象となる矩形の集合を指定します。矩形の座標は、ImageDocument の傾き補正後の白黒ページを基準としています。このパラメーターには 0 を指定できます。この場合、画像全体からカラーオブジェクトが削除されます。

**Color**

\[in] [ObjectsColorEnum](/ja/fine-reader/engine/api-reference/enumerations/objectscolorenum) 型のこの変数は、オブジェクトの色を指定します。

**Mode**

\[in] [ObjectsTypeEnum](/ja/fine-reader/engine/api-reference/enumerations/objectstypeenum) 型のこの変数は、削除するオブジェクトの種類を指定します。画像全体のオブジェクト、背景オブジェクトのみ、またはカラースタンプと署名のみです。

<div id="return-values">
  ## 戻り値
</div>

このメソッド固有の戻り値はありません。代わりに、[ABBYY FineReader Engine 関数の標準戻り値](/ja/fine-reader/engine/api-reference/return-codes)が返されます。

<div id="remarks">
  ## 備考
</div>

このメソッドは、ImageDocument の [color](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) 画像プレーンにカラー フィルターを適用します。その他のページはすべて ImageDocument から削除されます。これらのページは、必要に応じて作成されます。

指定した複数の色のオブジェクトを一度に削除し、それらを置き換える背景色を設定できるほか、削除したオブジェクトの画像も取得できる [RemoveColorObjectsEx](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/removecolorobjectsex-method) メソッドの使用も検討してください。ただし、このメソッドではオブジェクトの種類は設定できません。

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

[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument)
