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

# Methode Modify des ImageDocument-Objekts

> Methode Modify des ImageDocument-Objekts in der ABBYY FineReader Engine API — Wendet alle Änderungen an, die durch ein Objekt vom Typ ImageModification definiert sind (Zuschneiden, Zeichnen, Invertieren, Ersetzen von Pixeln, Entfernen von Bildstörungen, Strecken).

Diese Methode ändert das aktuelle ImageDocument. Alle Änderungen, die im Objekt [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification) definiert sind, können vorgenommen werden.

Gehen Sie wie folgt vor, um Änderungen vorzunehmen:

1. Erstellen Sie mithilfe der Methode [CreateImageModification](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) des Engine-Objekts ein Objekt vom Typ [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification).
2. Geben Sie die erforderlichen Parameter an.
3. Rufen Sie die Methode Modify mit diesem Objekt als Eingabeparameter auf. Die eigentliche Änderung erfolgt erst, wenn Sie diese Methode aufrufen.
4. Speichern Sie die Änderungen mit der Methode [IImageDocument::SaveModified](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/savemodified-method).

<Warning>
  Änderungen am Bild werden erst gespeichert, wenn die Methode IImageDocument::SaveModified aufgerufen wird. Wenn das Objekt [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument) freigegeben wird, bevor diese Methode aufgerufen wird, werden die Änderungen nicht gespeichert.
</Warning>

<Warning>
  Vor dem Aufruf dieser Methode müssen alle Blöcke aus dem Seitenlayout entfernt werden. Rufen Sie die Methode [ILayoutBlocks::DeleteAll](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteall-method) für die Sammlungen [ILayout::Blocks](/de/fine-reader/engine/api-reference/layout-related-objects/layout#blocks), [ILayout::BlackSeparators](/de/fine-reader/engine/api-reference/layout-related-objects/layout#blackseparators) und [ILayout::VisualBlocks](/de/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks) (Win) des entsprechenden Layouts auf.
</Warning>

<div id="syntax">
  ## 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">
  ## Parameter
</div>

**Modification**

\[in] Diese Variable vom Typ [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification) legt fest, welche Transformationen auf das Objekt [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument) angewendet werden.

<div id="return-values">
  ## Rückgabewerte
</div>

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die [Standardrückgabewerte von ABBYY FineReader Engine-Funktionen](/de/fine-reader/engine/api-reference/return-codes) zurück.

<div id="remarks">
  ## Hinweise
</div>

Alle Informationen über das ursprüngliche Bild gehen nach dem Aufruf der Methode verloren.

Diese Methode wendet Änderungen auf die [Schwarzweiß](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)-, [Graustufen](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)- und [Farb](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color)-Bildebenen des [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument) an. Alle anderen Seiten werden aus dem ImageDocument gelöscht. Sie werden bei Bedarf erstellt.

<div id="see-also">
  ## Siehe auch
</div>

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