> ## 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 オブジェクトの Modify メソッド

> ABBYY FineReader Engine API の ImageDocument オブジェクトの Modify メソッド。ImageModification オブジェクトで定義されたすべての変更（切り抜き、塗りつぶし、反転、ピクセルの置換、ごみの除去、伸張）を適用します。

このメソッドは、現在の ImageDocument を変更します。[ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) オブジェクトで定義されているすべての変更を適用できます。

変更を行うには、次の手順に従います。

1. Engine オブジェクトの [CreateImageModification](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドを使用して、[ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) オブジェクトを作成します。
2. 必要なパラメーターを指定します。
3. このオブジェクトを入力パラメーターとして指定して Modify メソッドを呼び出します。実際に変更が反映されるのは、このメソッドを呼び出したときだけです。
4. [IImageDocument::SaveModified](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/savemodified-method) メソッドを使用して変更を保存します。

<Warning>
  画像に対する変更は、IImageDocument::SaveModified メソッドを呼び出すまで保存されません。このメソッドを呼び出す前に [ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) オブジェクトが解放されると、変更は保存されません。
</Warning>

<Warning>
  このメソッドを呼び出す前に、ページ レイアウトからすべてのブロックを削除しておく必要があります。対応するレイアウトの [ILayout::Blocks](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)、[ILayout::BlackSeparators](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#blackseparators)、および [ILayout::VisualBlocks](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks) (Win) コレクションに対して [ILayoutBlocks::DeleteAll](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteall-method) メソッドを呼び出してください。
</Warning>

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

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

```cpp theme={null}
HRESULT Modify( IImageModification* Modification );
```

### C\#

```csharp theme={null}
void Modify( IImageModification Modification );
```

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

```vb theme={null}
Sub Modify(Modification As IImageModification)
```

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

**Modification**

\[in] この [ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) 型の変数は、[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) オブジェクトに対して実行する変換処理を指定します。

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

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

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

このメソッドを呼び出すと、元の画像に関する情報はすべて失われます。

このメソッドは、[白黒](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)、[グレースケール](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)、および[カラー](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color)の各画像プレーンに変更を適用します。[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument)内のそれ以外のページはすべて削除されます。これらのページは、必要に応じて作成されます。

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

[ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification)